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The Fine Print S 

The information in this document is subject to change without notice. The information in this document does not represent a " 

commitment on the part of anybody. 

No author, programmer, or anybody else shall be liable for technical or editorial errors or ommissions made herein; nor for incidental H 

or consequential damages resulting from the furnishing, performance, use, or inability to use this material. H 

If you are a commercial software developer and want to use any of the ideas you find here, you should also have the decency to 
mention the source of "your" idea. This includes (but isn't limited to) a certain commercial BBS system that recently came up with 

the idea of having a smart interface between its BBS and end-user modem software ... which is amazingly similar to Opus's FTB. B 

Copyright 1991, Wynn Wagner III 
All rights reserved. 

Printed in the United States of America. fl 
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1.0 Introduction to Opus 


(\XW^C ct^ 

- Ralph Waldo Emerson (1803-1882) 
U.S. author 


Gidday! 

Welcome to Opus, the Computer-Based Conversation System. 

You are given a limited licence to use the Opus-CBCS program as long as you use it in a 
LAWFUL and FRIENDLY manner. This is not public domain software and you are required to to 
follow the two licence requirements. There is no monetary fee. 

You may freely distribute the Opus-CBCS program, but it is not to be sold. If your system has a 
user fee, for example, you may not have Opus-CBCS on-line for download unless anyone who has 
not paid the fee can also download Opus-CBCS. Nobody is ever to make money from the 
distribution of the Opus-CBCS software. 

If you bought Opus-CBCS on diskette or by download, demand your money back in some lawful 
but unfriendly manner and report the vendor to your nearest Opus-Info system. 

If you need, or want, to say thanks for this system in some monetary way, you can send $50 to ... 

AmFAR 

5900 Wilshire Boulevarde, Second Floor, East Satellite 

Los Angeles, California 90036-5032 

USA 

AmFAR is the Americcan Foundation for AIDS Research, a non-profit, non-political, and non- 
affectational organisation that funds hundreds of AIDS research projects throughout the world. 

The Opus-CBCS program is copyright software. The copyright is held by Wynn Wagner III. The 
sole purpose of the copyright is to ensure that the Opus-CBCS program remains available for no 
money. The copyright is enforced. 


Nunzio 
Opus By-Laws & 
Covert Action Connmittee 


Because no money is charged. Opus sysops are not consumers. Opus is a community effort. 
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Icccy 

tivcxc^ m?" cly^t^ycU. ftxM4v ct*^ ^lee* 

^^Uu^cU. ^^4^^ tcccsx^c C4^^ ^C 

C'Xyc^x^u^c^ tly4\4x 

— from a conversation 


1.1 Guarantee 

You have to be kidding! 

Opus-CBCS carries only one guarantee: if you break it, you own all the parts. To put it another 
way, if you run Opus, you do so entirely at your own risk. 

The Opus-CBCS program may or may not work under your particular circumstances. If it does 
work, it is possible somebody will invent a way to destroy everything on your system. Opus 
contains lots of security features, but those features don not come with any sort of guarantee. 

However, you are most definitely not on your own. The Opus Community throughout the world 
are always willing to help, provided you observe the lawful and friendly Opus-CBCS licence 
requirements. Your best source of information and help is the FidoNet MEADOW Echomail 
conference. There are also Opus-Info help systems in the USA, Europe, Taiwan and Australia. 


1.2 Using Opus 

Lawful and Friendly are the important words. The original author, and copyright holder, of this 
software takes the license quite seriously, and if you use Opus you have to do so in a lawful and 
friendly manner. 


1.3 Credit and Gratitude 

The following folks have gone out of their way to help the Opus project. This is the "Opus; Sine 
Qua Non" (the list of folks, without whom there would be no Opus): 

WYNN WAGNER III — First Opus-CBCS author; Opus-CBCS copyright holder; He came, he 
coded, he produced Opus-CBCS. He invented the WaZOO session protocol which is the method 
now used in FidoNet for sending material from one BBS to another. He created Avatar, which is 
a video protocol now supported by such communications packages as Telix and QModem. .. 

DAVID FINSTER — Contributor to the Opus VO.00 documentation; Opus VI.00 alpha tester 

BOB HARTMAN — In addition to tweaking Wynn's SEAlink file transfer routine until it had a 
reasonable disposition, he is also the author of Opus! Comm (the first-ever FOSSIL program). 

RICK HUEBNER -- He sent code! Here are some of the modules that Rick originally wrote: 
OOMP (the internal Echomail scanner), Zmodem, and dialing scripts.. 
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MIKE KELLEHER ~ Original sysop of OPUSinfo ThereContributor to the Opus VO.00 
documentation. 

JOHN MILLER ~ The Opus VI.00 documentation editor. 

VINCE PERRIELLO -- The other alpha tester of Opus VI.00; he's also one of the prime 
instigators of the FOSSIL standard. He is the creator of a FidoNet mail program called 
BinkleyTerm, which began as a spin-off of Opus until it matured and was able to stand on its own 
as a major player in FidoNet. 

GEORGE STANISLAV - The first Opus VI.03 to VI. 10 author or "LCD" (Lower Code 
Dweller). He wrote AVATAR.SYS, which helped popularize the Avatar video mechanism... 

DOUG BOONE — The second Opus VI. 10 author; he pushed, coded, and kicked the Opus VI. 10 
release out the door when the world was wondering "Will Opus VI. 10 ever be ready?" Also 
responsible for Opus Vl.l 1 through VI. 14.. 

Not knowing the meaning of the word "quit" and ever a glutton for punishment, Doug also coded 
this VI.70 Opus release and about a ton of small utility programs used by sysops around the 
world. 

BOB DAVIS — The Opus VI. 13 Technical Reference Manual writer. 

JON SABOL “ Contributor to documentation for Opus VO.OO; the Opus VI. 10 & VI.20 Beta 
Coordinator. 

TOM KASHUBA ~ Known as "Kash." The Opus VI. 10 Gamma-Test Coordinator and author of 
the essential Opus VI.lx Opus MANager program.. 

BILL BOLTON - The original "OPUSinfo Under". 

JON MARSHALL -- The Opus VI.70 Gamma Coordinator; current maintainer of Wynn's Opus 
Matrix Message Masher code (oMMM).. 

JOHN VALENTYN - The Opus VI.70 files database coder, and adoptive parent of Doug's Opus 
File Area Manager (OPUS-FAM) program which he converted for Opus VI .70.. 

ULF NILSSON and TRANSLATORS — Opus VI.70 Language Coordinator, managed to find a 
group of people to keep their translations current while Opus VI.70 was in development AND put 
up with the "normal" American Anglocentric attitudes and misconceptions; Providing full 
language support would have been impossible vrithout all your help.. 

THOMAS SUNDBLOM — Who provided the idea for the automatic character set translation and 
gave us permission to use his table of character sets. 

TREVOR ROYDHOUSE - Australia. Opus VI.70 Document editor and author; Who did more 
typing?. 

PAUL KELLY, MICHAEL MASTERSON, BEV FREED - Three Opus VI.70 beta testers who 
seemed to find an unlimited number of bugs, quirks, and oddities. And provided an unlimited 
supply of suggestions. ... 


###### 

In addition to the active participants, the following should be mentioned for doing things without 
which we would have no Opus: 

^OPUSinfo is the name of some very special Opus BBS systems. They primarily support other Opus 
sysops. The first OPUSinfo was in Dallas (home of Opus). When San Francisco sprouted an OPUSin¬ 
fo. Dallas became "OPUSinfo Here" and San Francisco was called "OPUSinfo There." Europe was 
added as "OPUSinfo East" and Australia came on-line as "OPUSinfo Under." The Opus community is 
known for being serious about communications without also being solemn! 
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WARD CHRISTENSEN ~ He thought up both Xmodem and bulletin board systems.. 

TOM JENNINGS — He originated the worldwide amateur electronic mail network now known as 
FidoNet^M. 

CHUCK FORSBERG -- He designed Zmodem, the fastest and most reliable streaming file 
transfer protocol available.. 


1.4 Documentation Credits 

The Opus CBCS Sysop Operations Manual is intended to be a practical "how to" guide to setting 
up, customising and operating Opus VI.70. 

This manual is not the place to look for highly technical information on Opus VI.70; for that you 
should refer to the Opus Technical Reference Manual. Nor was it written as an installation or 
conversion manual for Opus VI.70 (although it may help); for those you should refer to the Doug 
Boone’s STARTUP.DOC and CONVERT.DOC files. 

No document would be complete without giving credit to those who contributed to the effort. First 
and foremost, I want to thank DOUG BOONE. Again. Heaven only knows how he found the time, 
but he was always there to answer my questions and look over the documentation, even at the 
eleventh hour. I also have to thank my wife, Adrienne, who has put up with my living in front of 
this screen and keyboard for the last couple of weeks and more than usual anti-social behaviour. 

Others who contributed to this documentation included (in alphabetical order): Bob Davis, 
Beverley Freed, Dave Hatch, Tom Kashuba, Paul Kelly, Robert Lilly, Robert Michal, Graham 
Stair, George Stanislav, John Valentyn, and Wynn Wagner III. 

Who were the rest? Maybe you? How? I cannot stress enough how valuable a resource the 
MEADOW Echomail conference is when it comes to information about Opus. I have been an avid 
reader of the conference since it first became available in Australia in 1987. If you do not 
regularly read the MEADOW, you are most definitely missing out on part of Opus and the sense 
of Opus community. 

Trev Roydhouse, 13 July 1991. 


1.5 Corrections^ Suggestions 


Please send any corrections, suggestions, observations, wishes, etc to me at; 


Fidonet 3:711/401 (PEP) 
FidoNet 3:711/501 (V32) 


International 

Domestic 


FAX +61-2-887-1702 
FAX (02) 887-1702 


PO Box 1605, 


Macquarie Centre, 


NSW 2113, 


Australia. 
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1.6 Miscellaneous 

Fido and FidoNet are trademarks of Tom Jennings. 

The SEAlink file transfer method is copyrighted by System Enhancements Associates. They have 
released the protocol for general use in return for this notice. 

The word "opus" is Latin for "project." The plural of "opus" is "opera". Although some Opus 
system operators have adopted a certain penguin as a mascot, you should know that this is not 
official. Opus- CBCS software has nothing to do with the comic strip Bloom Coimty that has a 
character named Opus. Any matters involving copyrights and/or trademarks on the penguin are 
between you and The Washington Post Co. 
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2.0 Opus VI .70 Overview 


trCct i^Ctiv O^U'l^ 

— Roger Levian 


Opus is an evolving computer-based conversation system that combines simplicity with 
configurability. Simplicity, in that a novice can have a rather nice bulletin board up and running 
without being a rocket scientist. Configurability, in that an advanced sysop can turn the 
customization of the board into an art form. It is entirely up to you! 

Therein lies Opus's charm: it has all the power an advanced sysop demands, while still being easy 
for both the user and the system operator. 

Opus provides a feature-rich electronic messaging system, wide choice of file upload and 
download protocols, plus access to the world's premier amateur electronic mail network. Clearly, 
it would be a bargain at twice the price! 


2.1 What is New in Opus VI.70 

Opus 1.70 is a major internal structural change that is moving towards more of a database design 
instead of having tons of little files out there with which to deal. And yes Virginia, we are still in 
the small memory model.^ 

One important point to realize is that you can throw out nearly all the limitations that were in 
Opus 1.14. 


System Limitation 

Opus 1.14 

Opus 1.70 

Number of file/message areas 

254 

32,765 

Number of boards you can scan to 

12 

255 

Maximum Echomail message size 

10k 

60k 

Maximum number of lines in messages: 

60 

250 

Full point support 

No 

Yes 

Full zone support 

No 

Yes 

Number of OECs you can run 

10 

No limit 

Number of menu items available 

71 

116 

Number of menus 

9 

14 


2.1.1 System Files 

The SYSTEM* .DAT files are gone, replaced by a mini-file area database and mini-message area 
database and five index files. These index files are true buffered Bplus trees which will give you 
very fast lookups. 


^This feature list is loooooooong! This thing is longer than some of the new user questionnaires IVe 
seen some of you put on-line. —Wynn 
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2.1.2 User and Event Files 

• The event file is largely the same as Opus VI. 14. There is some new information in the 
header of the schedule file to track the ID's of new users; 

• In the user file there is some new information added (see configuration & history menu 
details below); 

• The lastread pointers stored in the user file are superseded by individual last read pointer 

files in each message area. Opus now keeps track of the highest message read and ^e last 

message read separately; 

• The user file is indexed using a buffered Bplus tree to give fast lookups; 

• Opus is also tracking the total number of messages that a user has read and the total number 

of messages that they have entered. 


2.1.3 User Keyboard Macros 

• Opus vvill store 3 user keyboard macros (message, file macro and default) of up to 15 
characters in the user record. 

• Opus will choose the macro that matches where the user is in the menu structure. If the user 
presses the macro key in the message menu. Opus will execute the message macro. Opus 
will execute the default macro at any menu except the message and file menus. 


2J.4 Menus 

• In HiTech the ’>' after MORE in HiTech is blue and will flash, which hopefully will draw 
people's attention to it; 

• You can substitute your own menu prompts; 

• Users can choose to have the number of minutes remaining displayed as part of the menu 
prompts; 

• NACL will allow '*', '@' and for menu options; 

• You can define a file to be displayed to users as fancy, slow ASCII fiill-screen video menu at 
the MAIN / CONFIG / SYSOP / SECTION / CUSTOM menus if the user has graphic 
(ASCII) menus turned on. The Opus menu will follow unless the user's help level is 
"expert". 

• The Echomail and matrix menus have been eliminated. Instead there is one, single message 
menu for all areas. 


Section Menu 

• Sections are used to break an Opus into "sub-boards" or "SIGs". You might have a 
"Programming Section". File and message areas that relate to programming would all list 
that as their section, and underneath that you might have a "C Section" and a "Modula 2 
Section" and so on. When a user goes into a section they only have access to other areas that 
match that section. Message Scan and file Locate for example would be narrowed down by 
going into a section. 

• Sections are selected/used like locks and keys, except that users can directly change their 
sections. 

• Users can make their own selection of message and file areas to be included in user defined 
sections. Opus remembers users' sections next time they logon. Users can choose to unselect 
their user defined, or sysop defined, section and revert to none. 


Config Menu 

New configuration options allow users to: 

• return to their last menu after logging on, after going through the usual logon procedure. The 
only difference is that instead of the MAIN menu being the menu where users are dumped, it 
will be the last menu they used on their last call; 
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• select what type of full-screen video to use every logon, right after giving their password; 

• have hotkeys at all help levels; 

• get long, tedious graphic (ASCII) menus in addition to the Opus menus; 

• display the number of minutes left on-line for this session as part of the menu prompt; 

• turn on/off being interrupted by other users on a multiline system with multiline chat 
available; 

• set a default file transfer protocol. WARNING: This may mess up the Zmodem "R)Zupload" 
that a lot of us use. 


History Menu 

• The configuration menu has been split into a "history menu", which is information about the 
user (eg password, city, language, telephone, alias, street address, birthday, and how listed in 
the user list) and a configuration menu which is how the user sees Opus. 

• Users can now change their logon name. 

• Users can now change their alias. 

• The history menu can be added to any menu, eg the main menu or the configuration menu, or 
both. 


Message Menu 

New options allow users to: 

• search forward from the next message to the last message looking for messages that are To: 
the current user. When it finds one. Opus stops and displays the message; 

• search forward from the current message looking for a match to a string that the user 
provides, then displays the messages it finds. This command remembers the last search 
string that a user asked for, so hitting a return will allow a user to continue a search without 
having to type in the string for each match; 

• review the rules at any time, even after reading messages. It is a "smart" menu item which 
only appears on the menu if RULES .BBS or RULES-.BBS exist in the message path; 

• allow users to enter a message to Sysop from wherever the option is available. It is a variant 
of the logoff message in that users are not asked for names or subject or anything. 


File Menu 

New menu options added to allow for: 

• searching the entire files database for files added since the user's last call, or the user can 
override it and specify a number of days; 

• downloading and automatically disconnecting if Opus thinks the download went 
successfully; 

• H)urling files across drives if there is enough room on the target drive; 

• setting a temporary upload/download path. Opus will not ask for descriptions for files 
uploaded in the temporary directory and they will not be included in files database. 

• adding files to the files database from the keyboard. 


Custom Menus 

• Opus VI.70 allows the sysop to create up to 6 different custom menus. These menus may be 
attached anywhere. There is a limitation: only "global" menu commands can be attached to 
custom menus (refer to section 3 of the Opus VI .70 Technical Reference Manual). 


LORE/OpEd Menu 

• New editor command to have Opus ask for a file name. If you have started editing a message, 
it is lost, only the file is saved; 
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• The LORE help file will be shown the first 2 times the user enters a message via LORE, 
instead of during the first 5 calls. 


2.1.5 Version 7 Nodelist Support 

• Uses less than 70% of the disk space needed for the Version 6 nodelist, includes Sysop 
names, will insert Sysop name in net mail. Use of the Version 7 nodelist is optional. Opus 
still supports the outdated Version 6 nodelist. 

• If you do use the Version 7 nodelist then Opus will list the Sysops when listing boards. 

• When Polling between callers. Opus will accept either an address or a Sysop name. 

• You can set the privilege needed to see who the Sysops are for the boards when listing 
boards in netmail or from the Matrix Menu. 


2.1.6 System Section 

• Opus will optionally answer the phone itself instead of relying S0=1 in the modem 
initialization string. 

• Opus will support the new HST/DS HST modem CONNECT 14400 connect message. 

• You may specify the path to find/put echotoss.log and also the name of your echotoss.log. 
Opus now uses echotoss.Log for its internal Echomail scanner, so external programs that use 
the echotoss.log will be picked up by Opus. 

• Enable multiline chat ... this is not a real multiline chat, but at least messages can be sent 
between tasks. 

• Tell Opus that its being run on a LAN and it should behave like a multitasker was being run 
(ie create INMAIL##.$$$ files). 


2.1.7 Language Section 

• Opus supports the multiple character sets as set out in the file FSC-0050 and as 
implemented in the program OPMED 3.0; 

• The number of user-defined languages has been expanded from 6 to 12; 

• Option to change the IBM line-drawing characters in Opus to lotek ASCII characters instead 
of the high-bit characters. 


2.1.8 Equipment Section 

• Rudimentary mouse support (sysop configurable on/off) 

• Four configurable predial strings for dialling outbound calls. Opus will check the Modem 
byte in the nodelist, and if it is set to one of these values Opus will use the predial string that 
corresponds to the first match. If no modem flag has been set for a node. Opus will use its 
default dial prefix string. 


2.1.9 Matrix and Echomail Section 

• You can increase a user's Matrix Credit while a user is on-line; 

• A new option to tell Opus that if it cannot find an address in the nodelist to send the mail to 
the Net Host instead of marking it as "undialable". (This only works with the Version 7 
nodelist); 

• New options to ask users of the specified privilege and above whether the message is a file 
request or an update file request. 


Multi-zone Support 
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• Opus will handle multi-zone holding areas (ie zoned outbound directories: outbound.###). 
You can still put everything in a single outbound directory, but if they exist Opus vrill use 
the outbound.### directories; 

• If you give an address in the definition of an Echomail area, Opus will use that address in 
your messages from that area; 

• If you have multiple zone / net /node addresses. Opus vrill use its "best fit" address for the 
calling/called node in the YooHoo packet instead of the first (primary) address. 


PointNet Support 

• Opus will run as a BOSS node and strip off a point's SEEN-BY and Origin lines and put on 
yours; 

• Opus will also run as a point; 

• You can either be a BOSS or a POINT, but not both. 


External Mailer Hooks 

• If you give the CTL file an External Mailer string to look for, if Opus sees that string at the 
name prompt it will create a "MAILER.BAT" file and exit with the specified DOS 
errorlevel. 


UUCP Support 

• When forwarding messages to the netmail area, if the message is "To; uucp". Opus will not 
insert the From/To/Date stuff at the head of the text of the message so the UUCP address 
will be preserved as the first line in the message; 

• UUCPlist is like FidoUser.Lst, except it is a list of UUCP addresses, not FidoNet addresses. 
If this option is on, you simply enter Netmail messages with the person's name on the 
address line; 

• If a message has a UUCP address on it, you can set a privilege level for a new command that 
will allow some people to delete the UUCP address that has been read out of the original 
message; 

• When entering a message to "UUCP", Opus will put in the address of your UUCP gateway 
automatically; 

• In the MATMX section of the CTL file you can specify an address so that if Opus is sending 
a reply back to a UUCP address, the message will be routed to this address automatically 
instead of wherever it entered FidoNet. 


2.1.10 Session Section 

New options added to: 

• use/update LASTREAD for the Sysop who uses an external message editor; 

• define the file to be displayed if user does not get the password right; 

• define a file where all downloads will be logged; 

• define a file where all uploads will be logged; 

• encrypt the users' passwords in the user file (they cannot then be unencrypted); 

• control the privilege needed to download or check the contents of files that are not listed in 
the files database. 


User Logon 

New options added to: 

• prompt new users for either their ALIAS or REAL name at first logon after they have entered 
their name the first time; 

• allow new users to choose from the languages the sysop has made available; 
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• toggle on/off whether or not to ask new users for their city/state; 

• specify a default number of days until new users' access expires; 

• specify a default number of minutes until new users' access expires; 

• specify default keys for new users; 

• specify a default section for new users; 

• define a file to help the user with new user logon configuration; 

• allow users / new users who have a specified privilege to logon without giving any password. 


Special Configuration Logons 

• A user, even a new user, can enter their name plus a string of configuration commands at 
logon. These commands will override whatever has been stored in the user record or, if it is a 
new user, bypass the "Mirror shades" questions entirely; 

• Opus will accept namel name! /pmypwd for quick logons. 


2.1.11 Files Database 

This is actually a system of three files. One file contains all the information about what files you 

have on your board, one is the index to all the file names on your board, and one is an index into 

the first file in each file area. 

• You can specify where in each file area listing new files will be added either when uploaded 
or hurled. Normally new files are appended to the end of the listing. 

• You can specify full paths to files if they are not in the default directory for that area. 

• Who uploaded the file, and when, is stored with each file. 

• The file date and time is preserved when files are received via Zmodem transfers. The search 
for new files will look at the upload date/time, but the users will see the actual file creation 
time when they do a F)iles listing. 

• When a user does a L)ocate, or searches for a string with the F)iles command, they will also 
optionally get an additional line of information including who uploaded the file, when, and 
how many times it has been downloaded. 

• The F)iles display has been modified so it does a word-wrap for users who have screens 
wider than 60 characters. Descriptions can be up to 256 characters each. 

• Each individual file can have its own download privilege and locks. 

• When attempting to do a download, if the file is not in the current area. Opus will try to 
jump to the area where the file is located. Privileges and locks are honoured. 

• Opus will not allow users who have privilege below ASSTSYSOP to upload duplicate file 
names anywhere unless you specifically allow duplicate files. 

• If a user has never been in a file area. Opus will show them a RULES file if one exists. 

• You can specify file areas from which files may be downloaded without being counted as 
part of the ratio or daily download limit. 


File Areas 

• File and Message areas are now completely separate. There is no place where they interact 
with each other. Even the barricade paths can be completely separate; 

• In both the file and message areas you can embed an 

• "applications" string in the area definition in the database for use by, eg, an intelligent 
message renumberer; 

• The number of external protocols Opus will accept has been increased from 8 to 16. 

• During a file L)OCATE, Opus will list the areas as they are checked. 

New options added to: 

• define what section(s) an area should be considered to be part of; 

• define a file in each file area to be shown before the file listing; 

• specify a private upload path; 
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• specify a private upload path user privilege. Uploads from users with the specified privilege 
or greater will go to the private patti; 

• specify a private upload key; 

• specify a private upload key path where uploads from a user with the private upload key will 

go; 

• define a file to be displayed to a user before the Opus menu for this file area if they have 
full-screen video (ASCII) menus turned on; 

• define ratio privileges in file areas. Ratios only come into effect if the user's privilege is 
equal to or below what you set for that area; 

• specify the privilege necessary to display the information stored in the files database on who 
uploaded new files; 

• allow duplicate files to be uploaded in a specified file area. Opus will then not check for 
duplicate files when uploads start in this area; 

• specify that files uploaded in a particular area will be assigned a specified privilege for 
downloading; 

• show the two-line listing instead of the single line listing; 

• specify a privilege level for displaying who uploaded files (the date of upload and how many 
times downloaded info will still display in two line listings). 


2.1.12 Message Areas 

• File and Message areas are now completely separate. There is no place where they interact 
with each other. Even the barricade paths can be completely separate; 

• In both the file and message areas you can embed an "applications" string in the area 
definition in the database for use by, eg, an intelligent message renumberer; 

• Opus will check to see if private messages are to either the user's name or current alias. 

• The 10k limit on Echomail messages has been lifted, instead you can specify a limit in the 
CTL file from 3k up to 60k; 

• The 60 line limit on messages has also been lifted. Instead in each area you can specify a 
maximum number of lines, the default is 60, and Opus will give users that many lines or as 
many as it can in the amount of free memory it has available. The range of lengths that 
NACL will allow is from 10 to 250 lines. 


New options added to: 

• specify the keys needed to access the message upload command; 

• specify the privilege required to use the message upload option for this area; 

• specify the keys needed for users to read PRIVATE messages that are not to / from them; 

• specify the privilege needed for users to read PRIVATE messages that are not to / from 
them; 

• define a file that will be shown to users who have full-screen video menus on before the 
Opus menu; 

• define an ORIGIN line for use in each Echomail message area; 

• specify a DOMAIN for use with MSGID in a message area; 

• specify the ADDRESS for use in an area for the Origin line, MSGID, and SEEN-BYs. 

• specify the addresses to scan mail to. Opus VI .70 will scan to 255 addresses per area; 

• changes to the next area that has new messages in it up to the high message area set in the 

CTL file. 


2.1.13 Opus Embedded Commands 

• Skip the rest of the line if user section is equal to specified section; 

• Skip the rest of the line if user section is not equal to specified section; 

• Show the last date/time the user accessed a particular file area; 

• Show a specified file and return to the current location in the original file; 

• Show the rest of a line only if the user's baud is greater than or equal to a specified baud; 

• Record the current position in the current file, jump to specified position in the current file 
and return to original position when specified; 

• Stuff commands available from the current menu into the command buffer and quit the OEC 
file; 
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• If the user's help level is not equal to the help level on the line, the rest of the line is skipped. 

• Add specified keys for the user. This in addition to the default logon keys which may be 

specified in the control file; 

• Clear specified keys for the user; 

• Display the total number of messages a user has read; 

• Display the total number of messages entered by user; 

• Get and save a string up to 58 characters long from the user. When Opus hits a ^OC or ^OH 
or ^OG, whatever the user has entered will be appended to the command you gave. 

• Log special debugging info; 

• ^OC rereads LASTUS##.DAT, now there is an OEC that is identical in function, except that 
LASTUS##.DAT is not reread; 

• Send a message to the user on the current task. Sounds useless right? Well, suppose you 
added it to the end of BYEBYE.BBS ... 

• The ability to stack OEC files, where one file calls another and then returns to the original 
point; 

• Send a message to a specified task (like the inter-line chat menu item); 

• See who else is on-line on multi-line systems; Look for the interline CHAT## file and 
display it if it exists; 

• An OEC like ^OC which does not fill the command buffer with an ENTER when it returns; 

• An OEC like ^OC which does a system() call, does not re-read LASTUS##.DAT, and does 

not fill the command buffer with an ENTER when it returns; 

• Check for the existence of a specified file name. If the file does not exist, the rest of the line 
is skipped; 

• Run a program and return the DOS errorlevel of the program that was called; 

• Run a program (as above), but do not re-read LASTUS##.DAT; 

• Compare the DOS errorlevel returned from the program run (operates just like "if errorlevel" 
does in DOS batch files). 


2.1.14 Command Line Options 

• Force Opus to do an EchoScan right away. 


2.1.15 Niel Keys Extension 

• Opus will execute a batch file in the miscellaneous directory that corresponds to the function 
key pressed when it is waiting for a call. 


2.1.16 External Programs 

• Programs that are called from the menus as _OUTSIDE items. Opus will pass everything 
else that the user has typed as arguments after filtering it. Opus will filter out oA-":' 
characters. 


2.1.17 ERRORLEVEL Exits 

• Exit after upload; 

• Exit after local messages entered. 
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2.1.18Truly Miscellaneous 

• More [Y,n,=]? When users are listing areas, they quite often just type in a number and Opus 
says something about, "I do not understand 27, Use 'Y* for Yes and 'ISP for No.". 1.70 will 
just accept the number as an area selection and go on; 

• Opus will log the size of the file in file transfers, including mail transfers; 

• The low-level disk routines have been stripped down, the rust scraped off and they were all 
chromed and converted to _fastcall calls; 

• If the Sysop puts a jump to another menu but never defines that menu, users were cut adrift 
in limbo. Now Opus will check to make sure that there really is a menu to go to, and if not, 
will log the error, tell the user to tell the Sysop about it, and send them to the MAIN menu; 

• "Press ENTER to continue" will pass along any commands that have been typed in; 

• Fixed the timer so that if Opus is re-started with fewer than 3 minutes before a "hard" event. 
Opus will know that it should go into its "pending event" mode and drop DTR so no 
incoming calls will be accepted. 


2.2 Required Hardware 

In general, you have a reasonable chance of getting Opus 1.70 to work on any MS-DOS computer. 
Opus VI.70 uses a little more memory than VI. 14 to do some tricks. In Opus VI.14 the 
"minimum" was 128k plus the size of the nodelist index file. For Opus VI.70 the minimum is 
128k plus the size of nodelist index file plus the size of the largest *.USL file in your language 
directory; and if you are using the internal Echomail scanner in Opus VI.70, add the size of the 
maximum Echomail message you want to be able to handle. In most cases, you will want to be 
able to run external programs (eg file compressors and uncompressors) from Opus, and that 
requires anywhere from 256k to 400k depending on the file compressor you choose. 

Hardware incompatibilities are resolved through a special program called a FOSSIL. It contains 
modem, keyboard and video methods for specific hardware configurations. It means the same 
version of Opus can run on an IBM PC, an IBM PS/2, a DEC Rainbow or a Tandy 2K. The only 
difference is the FOSSIL program. 

Theoretically, Opus will use any modem that uses the Hayes command set and supports DTR. It 
has been successfiilly tested with the USR DS/HST, TeleBit, Netcomm, Dataplex, MultiTech and 
the Hayes families. If you use another modem brand. Opus should work but there are no 
guarantees. If you get other brands of modems to work with Opus, please contact one of the Opus- 
Info nodes and let them know the brand name, the initialization string and what you did to get it 
to work. 

Also, Opus requires a storage device larger than a floppy drive. Generally, this will be a hard 
drive, but could just as easily be cartridge media such as a Bernoulli Box. There are absolutely no 
plans to release a version that will run on floppies; the support files simply take too much room. 
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2.3 Required Software 

Several pieces of software are required to make Opus work. A couple are worth singling out. 
First, DOS 2.1 or higher ... 2.0 and below are not supported. In fact, not all the Opus features will 
work imder DOS 2.1. DOS 3.3 or higher is recommended for a fully-featured Opus system. iX is 
likely that future releases will require DOS 3.3 or higher. 

Next, the FOSSIL^. This is where Opus's low-level communications routines live. The FOSSIL is 
a memory-resident assembly language program or device driver designed especially for Opus. It 
supplies the routines Opus needs to communicate with the modem. If you are running other 
memory-resident programs, you may experience difficulty with the FOSSIL. Installing the 
FOSSIL last may solve the problem, but it is not guaranteed. Switching to another FOSSIL may 
also solve your problems. 


2.4 Messages 

Messages can be of three basic types, or scopes: local. Matrix and Echomail. A message's scope 
determines its behavior on an Opus-based system. 


2.4.1 Local Messages 

Local messages are the simplest form available, common to almost all BBS systems. Local 
messages are available to a predefined group of users on a single BBS — the one where they were 
entered. 


2.4.2 Matrix/Network Messages 

Matrix is the Opus word for network. This was chosen because of the ambiguity associated with 
the word "network". The Matrix is defined as a group of bulletin boards which can exchange 
information via the public switched telephone network (PSTN). 

Opus VI.70 can place outgoing Matrix calls, and receive incoming mail from other Opera,^ or 
other systems running either the FidoNeF*^ or WaZOO^ matrix protocols. 


2.4.3 Echomail Messages 

Echomail provides a means of maintaining the same message base on multiple bulletin boards. 
This allows conferencing — even internationally — if you choose to do so. Remember, phone calls 
placed for mail transfers cost the same as regular calls. Be aware that anything involving Matrix 
transactions can involve long distance phone charges. 


^FOSSIL stands for Fido-Opus-SEAdog Serial Interface Layer. 
^”Opera" is the plural of "opus" in Latin. 

^WaZOO stands for Warp-Zillion Opus-to-Opus. 
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2.5 Extended Message Area Attributes 

A variety of message area attributes are supported. With them, you can define exactly what type 
of messages will be placed in what area. 


Attribute 

Description 

Private only 

All messages entered in this area will be marked "private," and 
cannot be read by other users. 

Public only 

All messages in this areas can be read by ail users. 

Read-only 

Messages in this area can be read by callers, but only sysops and 
assistant sysops can enter new messages. 

Anonymous 

In an area marked as "anonymous," Opus will ask the user to 
supply a pseudonym. 

Alias 

In an area marked as "alias". Opus will use the user's alias on 
messages from the user. 

Echomail 

Conference-type message bases are recognized. The user will be 
told that the message will be broadcast, and Opus will 
automatically do such Echomail-oriented processing as inserting 
an "origin line" into the message. 

Inbound-only 

Echomail messages are tossed Into this message area, but 
messages are never scanned out to other systems from this 
message area. Useful for "read- only" Echomail conferences. 

Matrix messages 

These are treated like FidoNe^^ messages. The user is asked 
where the message is to be sent, to whom and to what address. 

Barricaded 

Barricaded areas may have a special password(s) associated with 
them so that only users who know the password(s) get the 
specified privilege level in that area. Barricaded areas may also 
have special privilege levels associated with certain users' names. 
By using this feature you can allow users higher or lower privileges 
in certain areas. 


These attributes may be combined in any fashion. You can require all messages in your Matrix 
area to be private, or all Echomail messages to be public. It is up to the sysop as to how message 
areas vvill behave. 


2.6 File Transfers 

Opus supports four different types of file transfers; uploads, downloads. Matrix and file requests. 
These enable the sharing of public domain or "shareware" software among users and other 
bulletin board systems. 


2.6.1 Uploads 

Uploading is defined as a user sending a file TO a BBS. This lets users share programs they have 
written or collected. 


2.6.2 Downloads 

Downloading is defined as a user receiving a file FROM a bulletin board system. This allows a 
single point to serve as a "holding tank" for software that can be freely shared among users. 
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2.6.3 Matrix 

Matrix transfers are uploads or downloads between two Matrix systems. You can direct Opus to 
send a file to any other system in the Matrix. Opus will accept incoming Matrix files any time it 
is not busy. 


2.6.4 Requests 

File requests are another variant of Matrix transfers between two Matrix systems. You can direct 
Opus to obtain a file from any other system in the Matrix which accepts WaZOO file requests. 
Opus does not initiate SEAdog-style "bark" requests (but will accept and process such requests — 
see below). 

Opus will accept both WaZOO and "bark" file requests from other Matrix systems, if it has been 
setup to do so. Any system can initiate a WaZOO file request simply by sending a file with a 
".REQ" file extension containing a list of the requested files. 


2.7 Extended File Transfer Protocols 

Several transfer protocols are supported in Opus. These include Zmodem, Ymodem, Xmodem, 
Telink, and SEAlink. Opus VI.70 also has 16 "slots" available for installation of external 
protocols, at the sysop's discretion — for example. Windowed Xmodem (WXmodem), Sliding 
Window Kermit, and YmodemG. These will be described more thoroughly in the file transfer 
section. The precise manner in which Opus interacts with external protocols is detailed in the 
Opus Technical Reference Manual; refer to that manual for the fine technical details. 


2.8 OEC File Capability 

OEC (Opus Embedded Command) files provide a world of customisation possibilities for you to 
explore. Opus Embedded Command files support both AVATAR and ANSI video codes as a user 
option. If you use Avatar graphic codes in files. Opus will send them to Avatar users, convert 
them into ANSI for ANSI users or strip them for TTY users. 

Through the use of an embedded command, you can make any support file branch to an external 
program. The sysop is responsible for ensuring that the program directs its output to the comm 
port. This feature allows multiple "Outside" features to be supported. 

Questionnaire information can be collected from within any OEC file. This can be used to log the 
activity of any displayed section of your bulletin board. 

You can insert a person's name, display a quote, date and time, etc., within any OEC file. 
Virtually anything Opus knows about the user can be displayed at any point in the support files. 
Additional embedded commands allow you to make any OEC file a submenu. This is handy for 
things like multiple bulletins, interactive help systems, etc. 

You will find a more details on OECs in the section of this manual on Setting Up Opus. For the 
complete list of OECs and the OEC file mechanism, refer to the Opus Technical Reference 
Manual. 
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2.9 Echomail Enhancements 

Opus lets the sysop decide whether Echomail SEEN-BY lines are displayed to the user. Few 
appreciate the unsightliness of this part of Echomail, and Opus eliminates that problem. If you do 
not care for SEEN-BYs, Opus lets you disable their display on a privilege level basis. 

The display of extended addressing can be disabled. As more distinct addresses become available 
over the Matrix, more information wiW need to be embedded within the body of messages. Opus 
lets you control who can and caimot see this information. 

Opus automatically inserts its own origin line if a message area is marked as Echomail. This lets 
other systems know which Matrix system originated the message and what software processed the 
mail. 

You can tell Opus to uncompress and toss compressed mail and Echomail packets automatically. 
You do not have to declare an external event to extract compressed mail packets and toss 
Echomail ~ Opus does this for you. 


2.10 AAatrix/Network Mail Interface 

Opus can receive mail at anytime. Matrix/Network transactions are not restricted to fixed time 
slots. You can also send mail to another Opus at anytime. 


2.11 Opus Operating Philosophy 

The operating philosophy of Opus is based on the KISS principle: 

Opus is easy to use if you let the installation kit do its job. A sysop can lead a very satisfying life 
with the basic Opus installation. It will still be a superior system, requiring a minimum of 
maintenance. There are thousands of custom features available; each Opus board will probably 
look and act differently, but there is no guarantee that any of the customization methods will be 
easy or immediately apparent. 

It is best to start with a basic system and to customize things gradually after gaining experience 
with Opus. The difficult functions are always available, but never required. If you want to tailor 
your system to look and act a certain way, you can, any time. The rewards you reap are 
proportional to the amount of work you put into the system, and that can run into years if you let 
it. 

On the next page is the motto: suitable for framing 
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3.0 


Setting Up Opus VI .70 
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-- Calvin Coolidge (1873-1933) 
30th U.S. President 


To set up a new Opus VI.70 system, or to convert from a previous version of Opus, refer to the 
separate installation manual. 

Having installed Opus VI.70, there are many ways to customise your shiny, new Opus system: the 
control file, the menu system, privilege levels and locks for access to message and file areas as 
well as menu commands, "sections" or "SIGs", barricaded message and/or file areas. Opus 
embedded command (OEC) files, bulletins, special annoimcements, custom welcome files and 
caller expiration control to name but a few. These, and others, are dealt with in the following 
sections. Let the fun begin! 


3.1 The Control File 

The Opus control files (BBS.CTL) is the single best place to find ways of customising your 
system. 

Please refer to section 2 of the Technical Reference Manual for a detailed description of the many 
control file options which are available. 


3.1.1 Control File Maintenance 

The control file (BBS.CTL) can be split into separate sections for easy maintenance or separate 
compilation. This is especially handy on multiline systems where you do not want to have to alter 
more than one control file to add a new message area. On single line systems, it is also handy to 
be able to just produce the BBS.PRM file rather than also regenerating all the necessary system 
files for the message and file area definitions and the menu system files. You can also do separate 
compilations of 

• the parameter file (BBS.PRM); 

• the file and message area system files (SYFILE.DAT, SYSMSG.DAT, 
NAME.FDX, NAME.MDX, NUMBER.FDX, NUMBER.MDX and ECHO.MDX); and 

• the menu files (e.g., ENGLISH.MNU). 
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3.1.2 The Parameter File 

To do a compilation of just the parameter (BBS.PRM) file you need to include the System 
Section, Language Section, Equipment Section, Matrix and Echomail Section and Session Section 
of your control file in BBS.CTL. You may keep these different sections all in the one file or each 
in its own file. 


If you split the different sections into separate files, your BBS.CTL might contain just the 
following lines: 


include 

include 

include 

include 

include 


c:\opus\config\system.ctl 
c:\opus\configXlanguage.ctl 
c:\opus\configXequipmnt.ctl 
c:\opus\configXmatrix.ctl 
c:\opus\config\session.ctl 


Running NACL BBS would then produce a compiled BBS.PRM file. 


3.1.3 File and Message Area System Files 

To do a compilation of just the file and message area system files, you need to include the File 
Areas and Message Areas Sections of your control file. You may keep these different sections all 
in the one file or each in its own file. In either case, you must put your File Areas before your 
Message Areas or NACL will laugh at you ... loudly! 

There is also one other special requirement in this situation. You must add a PATH OVERRIDE 
<path\> line to the beginning of your area files. The path you define here should be the same as 
you defined for PATH SYSTEM in the System Section of your control file. If you do not do so, 
yep, you guessed it in one, NACL will laugh at you ... loudly! 

If you split the File Areas and Message Areas Section into separate files, your AREAS.CTL file 
might contain just the following lines: 


include c:\opus\config\filearea.ctl 
include c:\opus\configXmesgarea.ctl 


Running NACL AREAS would then just produce the file and message area system files. 


3.1.4 Menu File(s) 

To do a compilation of just the menu file (eg ENGLISH.MNU), you need to include the Menu 
Section of your control file in a separate file (eg MENU.CTL). 

Running NACL MENU would then just produce the menu file(s). There is one gotcha though. 
The new compiled ENGLISH.MNU file will be in the directory from which you ran NACL. You 
need to move it to the directory defined with the LANGDIR option in the Language Section of 
your control file. 
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3J.5 All Files 

To compile your whole system, your BBS.CTL file might contain the following lines: 


include c:\opus\configXsystem.ctl 
include c:\opus\config\language.ctl 
include c:\opus\config\equipmnt.ctl 
include c:\opus\config\matrix.ctl 
include c:\opus\config\session,ctl 
include c:\opus\config\filearea.ctl 
include c:\opus\configXmesgarea.ctl 
include c:\opus\config\inenu.ctl _ 


or it might contain the following lines: 


include c:\opus\configXsystern.ctl 
include c:XopusXconfigXareas.ctl 
include c:XopusXconfigXmenu«ctl 


or for a multiline system you might have two BBS.CTL files like this: 

711_401.CTL _ 

include c:XopusXconfigXsys401.ctl 

include c:XopusXconfigXareas.ctl 

include c:XopusXconfigXmenu.ctl _ 


711_5Q1.CTL _ 

include c:XopusXconfigXsysS01.ctl 
include c:XopusXconfigXareas.ctl 
include c:XopusXconfigXmenu.ctl 


3.1.6 Macro Substitutions 

As if the ability to split the control file into its separate component section was not enough, you 
can also use macro substitutions in the control file. For example, your BBS.CTL might contain 
the following: 


Misc = c:XopusXmisc 
Help = ciXopusXhelp 
Task = 01 
Port = COM2 

include c:XopusXconfigXsystem.ctl 
include c:XopusXconfigXareas.ctl 
include c:XopusXconfigXmenu♦ctl 


The macros defined above are then used like this in the separate control files: 


PATH MISC 

$(Misc)X 

PATH SPANN 

$(Misc)X 

USES PASSWORD 

c:XopusXuser$(Task).dat 

USES SCHED 

c:XopusXsched$(Task).dat 

LOG FILE 

c:XopusXopus$(Task).log 

OUTPUT 

$(Port) 
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NACL would make the macro substitutions and interpret the above lines as follows: 


PATH MISC 

c:\opus\misc\ 

PATH SPANN 

c:\opus\misc\ 

USES PASSWORD 

c:\opus\user01.dat 

USES SCHED 

c:\opus\sched01.dat 

LOG FILE 

c:\opus\opus01.log 

OUTPUT 

COM2 


You can also use the macros in the include <filename> parameters like this: 


Node = 401 

include c:\opus\config\sys$(node).ctl 
include c:\opus\config\areas.ctl 
include c:\opus\config\inenu-ctl _ 


3.2 The Menu System 

The Opus VI.70 menu system is extremely flexible, especially with the addition of the six 
CUSTOM menus, the ability to use alternative menus in specified areas and the ability to replace 
the normal Opus menus. Menu prompts may now also be customised! 

Please refer to section 3 of the Technical Reference Manual for a detailed description and list of 
the many menu options which are available and how they may be implemented. 


3.2.1 Customizing Menu Prompts 

You customise the menu prompts by specifying the prompt you wish to use in quotation marks 
after the name of the menu in menu section of the control file. For example: 


MAIN MENU ”Sentry Main Menu” 


3.2.2 Controlling Access to Menu Commands 

A caller's access to menu options may be controlled by using one of the Opus privilege levels 
(Hidden, Sysop, AsstSysop, Clerk, Extra, Favored, Privil, Worthy, Normal, Limited, Disgrace, 
Twit) and by setting locks on the menu command to which callers will need the corresponding 
key(s). 

The format is: 


MENU_COMMAND !<locks> ”<description>” 


The first character of the description filed is used by Opus for the command letter that the caller 
should type to execute the command. Be careful not to use the same letter twice in the same menu 
or Opus will only ever let the caller execute the first command with the common command letter. 
Note that the use of locks on the command is optional, whereas a privilege level must be 
specified. 

For example, the file download command could require the caller to have NORMAL access or 
above and also the key for lock X. This is what the entry in the control file would look like: 


F_DNLD Normal IX "Download a file" 


Do not overlook the fact that privilege levels for some menu commands may be overidden by 
other control file options. For example, in the definition of a file area you can specify the 
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DOWNLOAD PRIV and the DOWNLOAD LOCK options which will override the privilege and 
locks you have set on the menu command for this area only. There are other similar control file 
options which vrill override menu command settings, please refer to section 2 of the Technical 
Reference Manual for the full list of such options. 


3.2.3 Displaying DEC Files 

Bulletin or help files may be shown to callers by adding the _SHOW menu command to any 
menu. You can add as many _SHOW menu commands to the same menu as you vrish. For 
example: 


_SHOW 

Twit 

"Software Bulletin" 

= c:\opus\misc\sware 

_SHOW 

Twit 

"Hardware Bulleton" 

= c:\opus\misc\hware 

_SHOW 

Disgrace 

"Editorial" 

= c:\opus\misc\edtorial 

_SHOW 

Twit 

"? Help" 

= c:\opus\misc\menuhlp 


Note that although you do not use a file extension on the name of the file to be shown, it must be 
an OEC file with either a .BBS or .GBS file extension. The .BBS files are preferred because if 
you use Avatar video commands in them. Opus will send Avatar to callers who support Avatar, 
and send ANSI video commands to callers who support ANSI or strip the commands for TTY 
callers who support neither Avatar nor ANSI video commands. A .GBS file is only shown to 
callers who support ANSI and is therefore largely superseded. Refer to section 4 of the Technical 
Reference Manual for a detailed description and listing of OEC commands. 


3.2.4 Running External Programs 

External programs may also be run from the menus. For example, here is a sysop menu you could 
implement: 


% 

SYSOP MENU 


SYS_MAIL 

Sysop 

"Matrix setup" 


_OUTSIDE 

Sysop 

"Events" 

= DOS c:\opus\oevent.exe 

_OUTSIDE 

Sysop 

"Outside" 

= EXIT 12 

_MAIN 

Sysop 

"Quit" 


_SHOW 

Sysop 

"? HELP" 

= c:\opus\hlp\syshelp 


END Menu 


Choosing the "Events" command would run the OEVENT.EXE (Opus Event Manager) program 
with the /a command line. Choosing the "Outside" option would cause Opus to exit to the batch 
file from which you run Opus (NERF.BAT) with a DOS errorlevel of 12. Your batch file should 
trap that errorlevel and act on it. See Appendix A for a sample NERF.BAT batch file. 

Refer to section 3 of the Technical Reference Manual for details of the various different methods 
of implementing the _OUTSIDE program option. Further discussion of these methods may also be 
found in section 7 of the Technical Reference Manual. 

For the correct method of implementing external file protocols (ie, so that Opus will keep track of 
caller uploads and downloads and daily limits), refer to section 7 of the Technical Reference 
Manual. 
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3.2.5 Global Menu Commands 

Global menu commands (those with a leading underscore character) may be included in any 
menu. For example, in the message menu you could add the following: 

_FILE _ Disgrace _ ”Jump to File Menu” _ 

to jump to the file area menu, and in the file area menu you could add the following: 

_MESSAGE _ Disgrace _ ”Jump to Msg Menu” _ 

to jump to the message area menu — all without having to go through the main menu! 

Refer to section 3 of the Technical Reference Manual for the fiill listing of global menu 
commands. 


3.2.6 Automatic Zmodem Upload 

Opus can be configured to receive Zmodem uploads automatically without the caller having to 
type UZ (Upload Zmodem). 

The Zmodem protocol states that the uploading software should start by sending 'rzV, in which 
the 'V stands for carriage return. Thus if your menu choice for upload is 'R' (as in RUpload 
Zmodem), the caller need type nothing, he/she just has to start sending the file(s) and the 
Zmodem protocol will let Opus know about it. 

You can add the 'R' option and keep the old "U)pload" option at the same time. Opus can handle 
multiple menu items with the same meaning. 

Note that this may not work right for the callers with Hotflash. After Opus receives the 'r', it will 
clear its menu buffer (thus discarding the 'z' and the CR) and ask what protocol you want. With 
all other types of menu, automatic Zmodem uploads work well. 

There is one last gotcha: if the caller has set a default file protocol, and that protocol is not 
Zmodem, this will not work! 


3.2.7 Superseded Menu Commands 

Some menu commands from Opus VI.lx versions have been superseded. Most notably, the 
configuration menu commands which dealt with things about the caller have been transferred to 
the history menu. 

Refer to section 3 of the Technical Reference Manual for the full listing of menu commands and 
details of which menu commands may appear on which menus. 


3.2.8 Alternative Menus 

There is truly no end to the flexibility of the Opus Menu System. For each area, for very special 
purposes, you can define an alternative menu file to use just for that area. With alternative menus, 
you can create a special personality or command set for a particular area. 

To implement this feature, copy your current menu section from your control file to a separate file 
and call it, for example, MENUOOl.CTL. Use your trusty wordprocessor to customise those 
menu(s) that you wish to be different. 

Now compile just that menu file by running NACL MENUOl. NACL will produce a new 
ENGLISH.MNU file in the directory from which you ran NACL (so do not run NACL in the same 
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directory as your existing ENGLISH.MNU file!). You should now rename your new 
ENGLISH.MNU file to ENGLISH.OOl. 

Wait a minute ... you now need to edit the MENU <number> option in the relevant message 
and/or file area definitions in your control file to reflect the particular menu number you wish to 
be used for those areas. For example, you may wish to use the modified menu only in Message 
Area 20. You would modify the message area 20 definition like this: 


AREA 0020 SPECIAL 
MENU 001 

etc 


Recompile your control file with NACL (or just the file and message area definitions section of 
the control file -- refer to section 3.1.1 above for how to do this). Now when Opus svvitches to that 
area, it would use ENGLISH.OOl instead of ENGLISH.MNU. 

Note that if you support more than one language, you would have to create an alternative menu 
with the same number extension for each language you support. 

You will generally not need to use this option for most situations. 


3.2.9 ASCII Menus 


Menu system not flexible enough for you? Yep, you guessed it. There is more. With Opus VI.70 
you can also implement what are somewhat misleadingly referred to as ASCII menus. These 
menus are really custom menus which you can use to replace the normal Opus Main, Config, 
History, Section, Sysop and six Custom menus. Opus rather cleverly uses smoke and mirrors to 
achieve this replacement. 

The ASCII menus feature was added so that sysops could replace the fairly quick-displaying 
Opus menus with those long, slow full-screen video menus that some sysops and callers prefer 
[climbing off soapbox]. 


Several control file options should be set if you are going to use this option. In the Session 
Section of your control file, uncomment the LOGON ASCIIMENU option (and make sure it is 
adequately described in your CONFHELP.BBS file). New callers will now be given the option of 
using ASCII menus and the option will also now appear on the configuration menu. 

You also need to uncomment each of the following options in the Session Section of your control 
file for which you are going to define a corresponding ASCII menu file: 


USES MainMenu MAIN 

USES ConfMenu CONE 

% USES SectMenu 
USES SysopMenu SYSOP 

USES HistoryMenu HIST 

% USES CUSTOMlMenu 

% USES CUSTOM2Menu 

% USES CUSTOM3Menu 

% USES CUSTOM4Menu 

% USES CUSTOMSMenu 

% USES CUSTOM6Menu 


Note that you do not specify a file extension for your replacement menu files. These files follow 
the normal OEC (.BBS/.GBS) file standard, so you can use any of the Opus Embedded 
Commands in them! Refer to section 4 of the Technical Reference Manual for a full description 
of OEC files and the complete list of OECs available. 

Now for the smoke and mirrors part. When a caller chooses the ASCII menu option at logon, the 
caller gets expert help automatically selected ... ahah, no normal Opus menus are shown, only the 
ASCII menus which you have defined. Of course, a caller can choose their help level from the 
configuration menu and might decide to set it to regular for the one line command letter prompts. 
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If the caller selects novice help, the caller will get the ASCII menus followed by the normal Opus 
menus. Smoke and mirrors are not that good! 


3.2.10OEC Menu Prompts 

A new opus Embedded Command widget in Opus VI.70 especially designed for menus is ^FM. 
This OEC simulates the current Opus (or your customised) menu prompts so that it looks to the 
caller as if the caller is still inside Opus and not inside one of your OEC files which was called 
from the relevant menu. 

Refer to section 4 of the Technical Reference Manual for the complete listing of the many OECs 
available. Some examples of the usage of OECs may be found in the Implementing OEC Files 
section of this manual. 


3.2.11 Menu Safety Feature 

If the Sysop puts a jump to another menu in a menu, but never defines that other menu, callers 
used to be lost in limbo. Now Opus VI.70 will check to make sure that there really is a menu to 
go to, and if not, will log the error, tell the caller to tell the Sysop about it, and then send the 
caller to the MAIN menu. 


3.3 Bombing Runs 

Check that you have your fiill complement of HE bombs on board and that the bomb bay doors 
have been properly secured, ooops, wrong document file. [Editor's note: this gag is probably 
copyrighted / patented / trademarked by Jon Sabol.] 

Opus lets you do message bombing runs (to use the old Fido-talk) or "carbon copies" (to use 
SEAdog^-talk). You can enter the one message and then send it to a bunch of other people. You 
might like to stop here for a few minutes and imagine just how unpopular you could quickly 
become with Network Hosts if you indiscriminately use bombing runs for Matrix messages ... 
<buzz>, sorry, wrong — you really cannot imagine. 

To use this feature you enter a message normally and save it. You then choose the Forward 
command (the MSG_FORWARD menu command) and Opus will ask you: 

• v\/hetherto use the same message area; 

• whether you wish to delete the original message; 

• whether to make the new message(s) private; 

• (if you are forwarding the message to the matrix message area or in the matrix 
message area, other questions may be asked depending on the MESSAGE EDIT 
ASSUME and ASK settings in your control file); 

• whether you wish to make a bombing run (yes, you do); 

• (if in the matrix message area, you may be asked for the matrix address of the 
addressee - ignore this by pressing ENTER); 

• for the addressee (ignore this, type something to keep Opus happy - if you 
answered private above, it must be someone in your user file); 

• whether you wish to use the original subject line; 


^SEAdog is a FidoNet mail program from System Enhancement Associates. 
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• for the route file! 

The "route file" must be in the following format: 


Zone : Net/Node ♦ Point First_Lastname <inode> 


where <mode> is optional and may be one of -c (crash) or -h (hold). Note that each part of the 
person's name must be separated from the other by an underscore. If you are logged in from the 
from the keyboard, you can specify CON for the route file and Opus will let you key in one 
Z:N/N.P F_L entry at a time. Press ENTER to finish. 


3.4 Implementing OEC Files 

Opus Embedded Command (OEC) files probably offer room for the most creativity. You can use 
embedded commands, video and cursor commands to create lavish vvidgets for callers. 

Entering the control codes for Opus Embedded Commands can be tricky depending on the 
facilities offered by your favourite wordprocessor for entering. There are some tools available that 
will make this task somewhat easier for you: OEC Compilers and a program called CTRLCODE. 

OEC compilers let you use "English" like commands to create your OEC files. You then 
"compile" these plain text files into the OEC files. The compiler translates the English 
expressions into the relevant control codes (correctly with a byte of luck). 

Grizzled Opus veterans will probably prefer to enter the control codes directly. Even this task is 
made considerably easier with the CTRLCODE program. This program lets you create a text file 
containing the caret sign "^" (the "^" sign is located above the number 6 on the top row of your 
keyboard) followed by the appropriate letter. So, you type which is two text characters, then 
run CTRLCODE which will convert those two characters into the corresponding single character 
control code. Follow that? Sorry, you really do have to be a grizzled Opus veteran <grin>. 

Example uses of only some of the many OECs available are set out in the following sections. The 
sections only just begin to scratch the surface when it comes to OECs. For the complete listing of 
OECs and explanation of OEC files, refer to section 4 of the Technical Reference Manual. 


2.4.1 Quotation of the Moment 

You can set Opus up to display a quotation of the moment to callers by, for example, embedding 
^F'^A in your WELCOME file (to show the quotation at logon) or your BYEBYE file (to show the 
quotation at logoff). If you are going to use the welcome or byebye files, do not forget to define 
the USES WELCOME and USES BYEBYE options in the Session Section of your control file 
(BBS.CTL). 

To use the quotation option, you must also have defined a quotation file with the USES QUOTES 
option in the Session Section of your Opus control file. For example: 


USES QUOTES c:\opus\inisc\quotes 
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The format for the quotation file is fairly simple. It is a normal text file. Each quotation is 
separated from the other by a single blank line. Here is a sample: 


Sex is hereditary. If your parents never had it, chances are you 
won't either. 

JOSEPH FISCHER 

Real knowledge is to know the extent of one's ignorance. 
CONFUCIUS 

A committee is a body that keeps minutes and wastes hours. 

W.G.P. 

A fool says "I can't"; 

A wise man says "I'll try". 

ANON 


You could also make the quotation of the moment an option off one of your menus. 


SHOW Disgrace "Quotes" = c:\opus\misc\quote 


And QUOTE.BBS would contain; 


Quotation of the moment: 

Ap^A 
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3.4.2 Passive Questionnaires 


Opus allows you to implement questionnaires in OEC files. Here is a sample questionnaire using 
OECs followed by an explanation (line numbers have been added for the commentary that follows 
only): 


00 



01 

'^OOc: \opus\misc\answers 

02 

^OP 


03 



04 


Stop typing by here --v 

05 


1-1 

06 

Street Address: '^ONAddress 

07 


1-1 

08 

City, State 

: -'ONCityState 

09 


1-1 

10 

Postcode 

: '^ONPostCode 

11 


I-- 1 

12 

Age 

: '^ONAge 

13 


1-1 

14 

Home Phone 

: '^ONHome 

15 


1-1 

16 

Work Phone 

: '^ONWork 

17 



18 

How did you 

hear about this bulletin board? (you have 2 Lines) 

19 

1- 

-1 

20 

-'ONInfo 


21 

2 

-1 

22 

^ONInfo 


23 



24 

Thanks, THE 

SYSOP. 

25 



26 

^A 



Line 00.turns off the More prompt which would otherwise mess up your questionnaire. 

Line 01.^00<filename> opens an answer file for the caller's responses and for the 

information collected in line 02. 

Line 02.'^OP posts the caller's name, city/state and the date/time of the call to the answer file 

declared in line 01. 

Line 03.Blank (purely for aesthetics). 

Line 04.Limit caller input; in fact. Opus will accept up to 79 characters plus an ENTER. 

Line 05.As line 04. 

Line 06.^ON<string> is used to collect input from the caller. The <string> is optional, but 

very useful for reminding sysops with short-term memory loss of the question that 
goes with the caller's answer. 

07-25.More of the same. 

Line 26.pauses the screen and prompts the caller to press ENTER to continue. 
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An answer file created by the above questionnaire looks like this: 


* Trev Roydhouse 

Remuera Auckland 

12 

Jul 91 11:46:18 

ADDRESS: 11 Westbury 

Crescent 



CITYSTATE: Remuera, 

Auckland 



POSTCODE: 5 




AGE: 

No 




HOME 

546-065 




WORK 

546-065 




INFO 

I saw your ad 

on Kinko's BBS a 

few 

weeks ago and have been 

INFO 

meaning to call ever since. 




3.4.3 Active Questionnaires 


As well as "passive" questionnaires, the Opus Embedded Commands also allow you to create 
"active" questionnaires. That is, questionnaires which ask questions or perform actions based on 
the caller's answer to the previous question. Here is a sample questionnaire using OECs followed 
by an explanation (line nos have been added for the commentary that follows only): 

00 



01 

^PNTX 


02 

'^OOc: \opus\misc\tennis 

03 

'^OP 


04 

'^F^F, are you 

a tennis fanatic? (y,N) '^ORYNI 

05 

'^OMFanatic 


06 

'^OUN 


07 

^OUl '^OQ 


08 

^OUY You are! 

Prove it ... 

09 

^OUY 


10 

'^OUY The year 

of the first Australian Davis Cup win was: 

11 

'^OUY a. 1900 

b. 1939 c. 1942 d. 1946 

12 

'^ORABCD 1 


13 

'^OMAnswer 


14 

"^OUB 


15 

'^OUB Correct! 

You will now have access to the Tennis 

16 

'^OUB Echomail 

message area. Type 40 or DEUCE at the 

17 

'^OUB Message ] 

Henu Change Area prompt. 

18 

^OUB '^PAT 


19 



20 

Wrong! 


21 

^PAX '^OQ 



Line 00 ..Turn off that pesky more prompt. 

Line 01 ..If the caller does not have the keys specified by ^PN<keys> (here the T key) sees rest of 
file (see below for significance of T). 

Line 02 ..See line 01 for explanation. 

NOTE 

^PNTX would not work -- that means if the caller does not have the T _AND_ X keys, 
see rest of file. 

Line 03 ..'^00<filename> opens an answer file for the caller's responses and for the information 
collected in line 04, 06 and 14 for the sysop's future reference. 

Line 04 ..^OP posts the caller's name, city/state and the date/time of the call to the answer file 
declared in line 03. 
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Line05..^F^F displays the caller's first name for the personal touch. ^OR<chars> defines the 
valid responses to this question. In this example they are Y, N or ENTER. 

Line 06 ..'^OM<string> posts the caller's answer to a multiple choice question in the answer file. 

<string> optional, but very handy for reminding the sysop with short-term memory loss 
what the question was that goes v^th the answer. 

Line 07 ..^OU<char> will execute if, and only if, the caller's previous response matches the 
specified character. ^OQ terminates the OEC file. 

Line 08 ..As for line 07, except that it caters for the ENTER response. 

Line 09 ..As for line 07, except that it caters for a Y response. 

10 - 12.... More of the same. 

Line 13 ..^OR<chars> see line 05 for explanation. 

Line 14 ..See line 06 for explanation. 

Line 15 ..See line 07 for explanation. 

16 - 18.... More of the same. 

Line 19 ..This line executes if, and only if, the caller's response was that specified by 
'^OU<char>; in this case B (the correct answer). 

^PA<key> adds the specified key to the caller's keys; in this case the key T is added to 
give the caller access to the Tennis echo. '^OQ terminates the OEC file. 

Line 20 ..Ah yes, some people will try anything! 

Line 21 ..But only once! See line 19 for explanation; in this case the caller is given the X key to 
prevent any further attempts (see line 02) to answer the question correctly. The ^OQ is 
probably not needed, but I like working with safety nets. 


An answer file created by the above questionnaire looks like this: 


* Trev Roydhouse 
FANATIC: N 

Behind 

The 

Screen 

12 

Jul 

91 

13:19:08 

* Joe Blow 

No Fixed Abode 

12 

Jul 

91 

13:24:27 

FANATIC: I 








* Trev Roydhouse 
FANATIC: Y 

ANSWER: B 

Behind 

The 

Screen 

12 

Jul 

91 

13:24:52 
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3.4.4 Sending a Message to the Next Caller 

You can allow callers, even on single line systems, to send a message to the next caller by using 
the ^FL OEC. Opus will not ask the caller which task to send the chat message to; it selects the 
current task. 

This OEC could be put in your BYEBYE file (make sure you have defined this file with the 
USES BYEBYE option in the control file) like this: 


Leave a message to the next caller? [y,N] 

^ORYNI 

'^OY 


Then the caller could leave a CHAT## to the current task number and hang up. The next caller 
comes on line and as soon as that caller hits a menu. Opus displays the message from the last 
caller. 


3.4.5 OEC File Stacking 

The '^OA<file> OEC starts displaying <file>. When <file> is done. Opus returns to the current 
file at the current position. You can stack this command. Here is an example: 


filel.bbs contains: 

files. bbs contains: 

This is filel.bbs 

This is files.bbs 

''OAfile2 

'^OAf ile4 

This is filel.bbs 

This is files.bbs 

-'OAfileS 


This is filel.bbs 

file4.bbs contains: 

This is filei.bbs 


files.bbs contains: 


This is file2.bbs 

files.bbs contains: 

•'OAfileS 

This is files.bbs 

This is files.bbs 



The above sequence of OEC files would display to a caller as follows: 


This is filel.bbs 
This is file2.bbs 
This is file3.bbs 
This is file4.bbs 
This is files.bbs 
This is files.bbs 
This is filel.bbs 
This is files.bbs 
This is filel.bbs 


This OEC uses a doubly linked list so the limitation is how much memory your system can find, 
but it is recommended that it be kept down to 4-5 deep. 
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Another method of OEC file stacking is by using the ^OX OEC. This OEC records the current 
position in the current file, jumps to <position> (position is the number of bytes from the 
beginning of the file) and when '^OY is encountered. Opus returns. Here is an example: 


This is the beginning of MAIN Menu.... 

^0X0105 

And this is back to MAIN.BBS 
'^OQ 

This is some point further along in Main MENU 
^0X0226 

This is back to mid-point further along in MAIN 

MENU 

^OY 

This is yet further along in MAIN MENU _ 


The above example would display as follows: 


This is the beginning of MAIN Menu.... 

This is some point further along in Main MENU 
This is yet further along in MAIN MENU 
This is back to mid-point further along in MAIN 
And this is back to MAIN.BBS 


This OEC can be stacked up to 10 levels deep. 


3.4.6 Command Buffer Stuffing 

The '^OG<command> OEC stuffs commands into the command buffer and quits the OEC file. 
You may use any commands available from the current menu. For example, if you have an OEC 
that ends with ^OGG, Opus quits the OEC file and starts the logoff procedure. You can also have 
it go to the download, upload, statistics, or any of the codes that are valid for the current menu. 
You can set up a fairly complex script via stacked commands, using either Escaped Hex codes or 
plain ASCII. 

Here is a script that you might use as a "fail-safe" to clear full-screen video: 


_SHOW Twit ’’If_All_Else_Fails" = c:\misc\bomb 

BOMB.BBS <ESC>10fl C V P H N Q 

(Main Menu, Change Menu, Video/Plain, Help/Novice, 
Quit to Main menu) _ 


Suppose at the end of an OEC file off your File Menu which listed "MY_LIST.BBS" you 
included: 


Download this file? 

Z)modem 
Y) modem 
X) modem 
K)ermit 
N) one 
'^ORZYXKN1 

'^OUZ dz my_list.bbs 

'^OUY dy my_list.bbs 

'^OUX dx my_list.bbs 

'^OUK <ESC>5 0 04 k my_list.bbs 

'^OUN ^OQ 

^OUI ^OQ _ 
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Opus starts the download with the right protocol if a caller wants to download the file. You can 
also use the Full Tilt Boogie (FTB) menu commands by preceding them with an escape. What you 
are doing is stuffuig the command buffer with keystrokes. If you send Opus off to do something 
illegal, because of privileges or whatever, it will be handled just as though the caller were 
pressing the keys. 

The full list of FTB commands is listed in section 4 of the Technical Reference Manual. 


3.4.7 Regulating Peak Time Caller Access 

To have Opus only allow those callers with a privilege level of Favored or higher to log on during 
specified hours, create two WELCOME files, a standard one named WELCOME 1.BBS and a 
special one named WELCOME2.BBS that has the following at the beginning: 


00 

01 ^PBF ^OSwelcomel 
02 '^PBF ^OQ 

03 

04 I’m sorry, but this system runs restricted access between the 
05 hours of (start-time) and (end-time). 

06 

07 Please call back after (end-time) 

08 

09 Thank You, THE SYSOP. 

10 

11 '^F'^N 


Line 01.Clears the screen (aesthetics again) 

Line 02.If caller's privilege is below Favored, skip this line. Callers at or above Favored are 

shown the normal WELCOME file. 

Line 03.Quit this OEC file now for Favored callers. 

04 - 10.Message for callers below Favored. 

Line 11.Hang up on callers below Favored. 

Then setup an informal external event to run at {start-time} that exits with a DOS errorlevel of, 
say, 50 which is trapped by your NERF.BAT file like this: 


IF ERRORLEVEL 50 GOTO REST_ACCESS 

[etc] 

:REST_ACCESS 

COPY WELCOME2.BBS WELCOME.BBS 
GOTO START_OPUS 


and at {end-time} run another informal external event that simply exits with a DOS errorlevel of, 
say, 49 which is trapped by your NERF.BAT file like this: 


IF ERRORLEVEL 49 GOTO REST_ACCESS 

[etc] 

:NORM_ACCESS 

COPY WELCOMEl.BBS WELCOME.BBS 
GOTO START_OPUS 


For a commented, sample NERF.BAT file refer to Appendix A of this manual. For information on 
scheduling informal events, refer to the section of this manual which describes the Opus Event 
System. 
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3.5 External Programs 

External programs provide lots of help in customising your Opus CBCS. Here are a few which 
were available at the time of publication: 


Program 

Description 

CAYENNE 

a program to de-compile your Opus control file, also used in conversions from 
the previous Opus version 

CONFILE 

a program to convert the old FILES.BBS file listings into the Opus VI.70 
files database 

DOORMAGIC 

a program to create various "door" control files for running "outside" or 
"door" programs written for other BBS software 

NACL 

a program to compile your Opus control file 

0 RENUM 

an Opus message area renumberer 

OEVENT 

the Opus event manager 

OFARE 

a program to re-index your Opus VI .70 files database 

OPHONE 

an external chat program 

OPUS-FAM 

the Opus File Area Manager 

OUFM 

an Opus User File Manager 

PTIC 

a program to add new "ticked" files to the files database 

UNCON 

a program to unconvert the new Opus VI.70 files database into the old 
FILES.BBS file listings 


3.6 Message Areas 

Message areas and the method of storing messages in Opus VI.70 are the same as in previous 
versions of Opus. The setting up and maintenance of message areas is discussed in the following 
sections. 


3.6.1 Checklist for New Message Areas 

Checklist for setting up a new message area: 

1. Create a subdirectory for the message area; 

2. Edit your BBS.CTL file to include the new message area definition In the Message 
Areas Section; 

3. Run NACL against your modified BBS.CTL file (refer to the section of this manual 
on control file maintenance for the gory details). 
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3.6.2 Sample Message Area Definition 

Message area definitions are found in the Message Areas Section of your control file. Here is a 
sample message area definition which lists all the possible control file options for such a 
definition: 


AREA 

001 

GENERAL 


% 

NAME 

<Name(s)> 


% 

MENU 

<Number> 


% 

SECTION 

<Sections> 


% 

PRIVATE MESSAGES ONLY 


% 

PUBLIC MESSAGES 

5 ONLY 


% 

READ-ONLY 



% 

ANONYMOUS OKAY 



% 

ALIAS 



% 

ROUTE 



LOCAL 



% 

ECHOMAIL 

<tag> 


% 

MATRIX 



ACCESS PRIV Disgrace 


EDIT 

PRIV Disgrace 


% 

ACCESS LOCK 

<Iocks> 


% 

EDIT LOCK 

<Iocks> 


PEEK 

PRIV Sysop 


% 

PEEK LOCK 

<Iocks> 


% 

Upload PRIV 

<privilege> 


% 

Upload LOCK 

<Iocks> 


PATH 

c:\msg\general\ 


TITLE General Interest 

Messages [Local] 

% 

MAXLINES 

<number> 


% 

BARRICADE 

<filename> 


% 

ADDRESS 

<zone:net/node.point> 

% 

ORIGIN 

<string> 


% 

DOMAIN 

<string> 


% 

PICTURE 

<filename> 


% 

HELP 

<f ilenaine> 


% 

CHARSET 

<ISO set> 


% 

PASSTHROUGH 



% 

INBOUND-ONLY 



% 

SCAN 

<net/node . 

. . > 

Q, 

'O 

APPLICATION 

<string> 


% 

EXTERN RENUM 



% 

EXTERN MAILCHECK 


END . 

AREA 




You guessed it, please refer to section 2 of the Technical Reference Manual for a detailed 
description of each of the control file options in the sample message area definition above. 

NOTE: In pre-V1.70 Opus versions, areas had to be numbered consecutively. If you skipped a 
number, all higher-numbered areas were invisible to callers; although they were still accessible, 
they did not appear on the Opus-generated area change list. 

This does not apply to Opus VI.70. All message areas will show up on the Opus-generated area 
change list except where the caller does not have thee required privilege level or key(s). 
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3.6.3 Arealnfo Files 

You can put an AREAINFO.BBS (or AREAINF~.BBS file for systems which support more than 
one language) file in each message area directory. This file will then be shown to every caller 
each time the caller enters the relevant message area. 

You could use the file for displaying the rules of that specific message areas. It is particularly 
useful in trading post Echomail areas for warning callers not to place commercial advertisements, 
for example. 

As the file is a normal OEC file, you can stop it being shown to your trusted callers over and over 
again by using OECs to only show it to those with a certain access level or below or without 
certain keys. 


3.6.4 Smart Rules Files^^ 

There is a "smart" menu command which you can use to allow callers to display the rules file in 
message areas. You put the MSG_RULES menu command on your message menu and it will only 
show up when a RULES .BBS (or RULE~.BBS file for those systems which support multiple 
languages) file is found in the relevant message area directory! 

In addition. Opus will automagically show the rules file, if it exists, to any caller whose lastread 
message pointer for the area is zero. 

In file areas, you need to define the rules file in the file area definition using the RULES control 
file option. The file will only be shown to those callers who have never before entered the 
relevant file area (you can cause it to display again by deleting the LFILE.DAT file in that file 
area's download directory — that file stores who was in the file area and when for use by one of 
the Opus Embedded Commands). 

Refer to section 2 (areainfo and rules files) and section 4 (OECs) of the Technical Reference 
Manual for further details. 


3.6.5 Message Area Maintenance 

Messages are stored in individual files. Message #1 is in a file called "l.MSG", for example. 

Large gaps between message numbers can cause big on-line delays. There are several public 
domain message renumber utilities. You should renumber message areas regularly. 

One thing you should also do occasionally: reorganize your physical drive. Several utilities are 
available (eg. Optimize, DOG, SD) to do such things. They are handy and highly recommended. 
In technical terms, these programs "de-ffagment" your disk. Run them once a month or so. 
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3.7 File Areas 

Probably one of the biggest changes between Opus VI.70 and previous Opus versions is the fact 
that VI.70 now uses a database for keeping track of files instead of the plethora of individual 
FILES.BBS files that the grizzled veteran Opus sysop either learned to love or loved to hate. 

Despair not! Utilities have been provided to convert FILES.BBS files into the new files database 
AND to unconvert the new files database into FILES.BBS files AND to manage the new files 
database. 


3.7.1 The Files Database 

The Opus VI.70 files database is actually a system of three files. One file contains all the 
information about what files you have on your system (FILESBBS.DAT), one is the index to all 
the file names on your system (FILESBBS.NDX), and one is an index into the first file in each 
file area (FILESBBS.ADX). 

Here are a few of the highlights of the new files database: 

• You can specify where in each file area listing new files will be added either when 
U)ploaded or H)urled by inserting a greater than sign > in the listing for an area. 
Nornnally new files are appended to the end of the listing for an area. 

• You can specify full paths to files if they are not in the default directory for that file 
area. This will probably be of benefit to those sysops who run CD-ROM drives on 
their systenns. 

• Who uploaded the file and when Is stored with each file. 

• The file date and time Is preserved when files are received via Zmodem transfers. 
The search for new files will look at the upload date/time, but the callers will see 
the actual file creation time when they do a F)iles listing. 

• When a caller does a L)ocate, or searches for a string with the F)lles command, 
they also optionally (sysop configurable by privilege) get an additional line of 
information Including who uploaded the file and when. 

• The F)iles display has been modified so it does a word-wrap for callers who have 
screens wider than 60 characters. File descriptions may be up to 256 characters 
long. 

• Each individual file can have its own download privilege and locks. Normally they 
will be set to the area's download privilege and locks, unless you have set the 
NEW PRIV option in the file area definition. You can also override the privilege 
and locks on a file- by-file basis. 

• If a caller tries to download a file from an area, and the file does not exist In that 
area. Opus will look for the file in all the other areas to which the caller has 
access and, if it finds it, the download will continue as normal! 

• Opus will not allow callers who have privilege below ASSTSYSOP to upload 
duplicate file names anywhere unless the DUPES option has been specified in 
the file area definition. 

• If a caller has never been in a file area before, and the sysop has defined a 
RULES file in that area's definition. Opus will show the caller that file. The idea 
behind this is that you might want to have some areas that have minimal 
restrictions on them, like an area that has nude GIF files in it. You could ask "Are 
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you over 18?" and if the answer is no, send the caller sonnewhere else using 
OECs. 

• If you implement the FREE control file option in a file area definition, then Opus 
will not consider files downloaded from that area to be part of the callers 
uploadidownload ratio or daily download limit This should work properly even 
when callers are downloading a batch of files from different areas. The only 
problem is that Opus will not know which files are "free" and which are not when 
reading the log file produced by external protocol drivers. It will add the file sizes 
to the total downloads and daily downloads when using an external protocol. 


3.7.2 Converting to the Files Database 

You convert your old-style FILES.BBS file area listings to the new files database by running the 
CONFILE program. 

Please refer to the documentation supplied with CONFILE for a blow- by-blow description of this 
procedure. 


3.7.3 Changing File Area Numbers 

What do you do when you want to move a particular file area to a different area number? For 
example, you want to make your current games files area which is area 15 into a new area 88. 
You have a lot of typing to do, right? Wrong. John Valentyn sent along this recipe just for you; 

1. Run UNCON to take all the file descriptions for area 15 from the files database to 
create an old-style FILES.BBS file for you; 

2. Edit your control file (BBS.CTL), changing file area 15 to file area 88; 

3. Run NACL against a copy of your control file that includes the Message and File 
Area Sections (refer to the section of the manual dealing with control file 
maintenance for more details); 

4. Run OFARE, which will see that area 15 has been deleted and that area 88 is a 
new area, and will merge the FILES.BBS for area 88 back Into the database. 


3.7.4 Setting Up New File Areas 

Checklist for setting up a new file area: 

1. Create a download subdirectory for the file area - the download subdirectory 
contains the files you want to make available to your callers; 

2. Copy the relevant downloadable files into the download subdirectory; 

3. As necessary, create an upload and/or private upload and/or keyed upload 
directory for the file area ~ the upload subdirectory/ies Is/are the hold any files 
that callers might send to you; 

4. Create an old-style FILES.BBS file listing which includes the descriptions of the 
files for the new file area -- the FILES.BBS file is a normal text file which contains 
the file names beginning in column 1, followed by a space character, followed by 
the description of the file; comment lines must be indented at least one space 
character or they will be treated as file names. 
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There is also an EFW^ bonus with the new files database - an "alternative file 
path" for pointing to files that are not in the relevant file area directory, but are in 
another directory elsewhere on your system. Why EFW? It saves you hard disk 
space! To take advantage of this EFW, you put the full path to the file in the 
FILES.BBS file In addition to the file name, for example: 


z:\file\thisfile.zip 


Folks with CD-ROM drives may also like to take advantage of the fact that you 
can also put the full path to a file in the FILES.BBS file, so that when it is 
converted in the files database, the file path will be correct. 

5. It is a good idea to leave 4 lines at the beginning of the new FILES.BBS listings 
so that the HiTech menus do not leave the topmost two or three lines of the listing 
on the screen ~ In fact, this is a feature and not a bug. The first few lines are 
reserved for the a file area heading which Is not erased each time the screen 
scrolls; 

6. Edit your BBS.CTL file to include the new file area definition in the File Areas 
Section of the control file; 

7. Do not forget to include an upload area number In your file area definition or you 
will experience this problem: 


> Also, I have uploaded files going into a particular 

> directory. The files go there, but when I do a new 

> files scan, they are listed in the area the caller was 

> in when the file was uploaded. In the area the caller 

> uploaded, the file and description are listed, in the 

> upload area, the file without a description are also 

> listed. 


UPLOAD PATH H:\NEWFILES\ <-I Path 

UPLOAD AREA 31 <-I Area # 


8. Run NACL against your modified BBS.CTL file (refer to the section of this manual 
on control file maintenance for the gory details): 

9. Run OFARE to update the files database. 


^EFW stands for "environmentally-friendly widget." 
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3.7.5 Sample File Area Definition 

File area definitions are found in the File Areas Section of your control file. Here is a sample file 
area definition which lists all the possible control file options for such a definition: 


AREA 0001 

% 

% MENU 

% SECTION 

TITLE 

% PREFILES 


INFO 


<Number> 

<Sections> 

Information File Area 
<filename> 


ACCESS PRIV Disgrace 

% ACCESS LOCK <iocks> 


% 

DOWNLOAD PRIV Disgrace 
% DOWNLOAD LOCK <Iocks> 
DOWNLOAD PATH C:\FILES\INFO\ 


% BARRICADE 
% RULES 

% PICTURE 

% HELP 

RATIO PRIV 


<filename> 
<filename> 
<filename> 
<filename> 

Twit 


% Default Upload Area 

UPLOAD PRIV Hidden 

% UPLOAD LOCK <iocks> 

UPLOAD PATH C:\FILES\NEW\ 

UPLOAD AREA 3 

NEW PRIV Disgrace 

% DUPES 

% FREE 

% 

% 

% PRIVATE Upload area by Privilege 

PUPLOAD PRIV Twit 

% PUPLOAD PATH <path\> 

PUPLOAD AREA 3 

% 

% PRIVATE Upload area by Keys 

% KUPLOAD LOCK <Iocks> 

% KUPLOAD PATH <path\> 

KUPLOAD AREA 3 

% 

% APPLICATION 


END AREA 
% 


You guessed it, please refer to section 2 of the Technical Reference Manual for a detailed 
description of each of the control file options in the sample file area definition above. 
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3.7.6 Files Database Maintenance 

When a caller uploads a file. Opus will automatically put the file into files database. 

To add, delete or move files from the files database, or to edit the file descriptions, use the Opus 
File Area Manager (OPUS-FAM) program. Uhuh, please refer to the documentation that comes 
with OPUS-FAM for full details of this procedure. OPUS-FAM will also run in batch mode to 
produce file listings for file request lists (see below). 

You can also use Opus itself to "adopt" files which are not listed in the database, "orphan" files 
that are listed in the database, and "hurl" files from one area to another including across physical 
drives! Yep, go check out section 3 of the Technical Reference Manual for the appropriate menu 
commands to include on your file menu. 

If you have other programs that need access to the old-style FILES.BBS file listings, use the 
UNCON program. UNCON with no parameters will regurgitate FILES.BBS in all areas, or you 
can put a list of areas on the command line and only those areas will get new FILES.BBS listings. 
UNCON.EXE will rename any existing FILES.BBS to FILES.BAK before writing the new 
FILES.BBS. 

To do minor, automatic maintenance there is OF ARE. OF ARE should be run as part of your 
automatic housekeeping like renumbering messages. It performs a number of functions, including 
re-packing the database as new files are added, expanding wildcard listings in the database to 
reflect any new files that have been added or deleted, eliminating files that have been deleted 
from the database and, optionally, eliminating any "Missing" files from your database. Here is a 
sample batch file: 


REM Sample nightly housekeeping 

REM Pick up any new files and remove deleted and missing files 
ofare /m 

REM Save the old files database in case of trouble 
pkzip -mex oldfiles filesbbs.o* 

REM Update FILES.BBS to match the database 
uncon 12345678 10 

REM Produce the FILES lists 

opus-fam -1 _ 
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3.8 Barricaded Message and File Areas 

You can "barricade" message and file areas in Opus so that a caller needs another password to get 
into the area. This password not only admits the caller to the area, but is associated with a 
privilege level which the caller will have only while in that area. Be careful that the privilege 
level associated with each password is equal to or higher that the privilege required for access to 
the area and its associated menu commands. 

Whenever users leave a barricaded message or file area, they lose the higher or lower privilege 
which was conferred on them. As an added security measure, if a user logs off or otherwise 
disconnects while in a barricaded area. Opus always resets the last message or file area accessed, 
as appropriate, to area number 1 and resets their privilege level to what it was before they entered 
the barricaded area. You cannot, therefore, barricade file area number 1. 

Unlike Opus l.lx, both message and file areas may be separately barricaded by defining a 
password file associated with the relevant area definition in the control file. 

To implement barricaded areas you need to define a generic "warning" file shown to callers who 
attempt to enter the barricaded area. This is defined using the USES BARRICADE <filename> 
control file option which you will find in the Session Section of your control file. Here is a sample 
warning file: 


Warning! Warning! ^G'^G^G 

This is a password protected area. If you have 
stumbled in here by mistake, press ENTER or RETURN to 
return to the system. 

Any other action will be recorded as an attempt to 
enter this area and you will be disconnected. _ 


In fact. Opus will not disconnect the caller if the caller incorrectly guesses the password twice in 
a row. Instead, Opus will return the caller to the area change menu. Your callers do not know that 
though! 

You also need to define a "password" file which contains the passwords and associated privilege 
level. The file may also contain a caller's name and an associated privilege level, in which case 
the caller will not be asked for a password, but will be admitted to the area with the assigned 
privilege (useful for co-sysops maybe). This password file is defined with the BARRICADE 
<filename> option in the area definition section of your control file. Each area may have its own 
password file, or you may use the same one in each area. Here is a sample password file: 


SESAME 

ASSTSYSOP 

; for 

area moderator 



SHILOH 

PRIVIL 

; for 

those who 

can enter Echomail messages 

GREYSTOKE 

NORMAL 

; for 

those who 

cannot 

enter 

messages 

PERFECT 

NORMAL 

; for 

those who 

cannot 

enter 

messages 

K9W3F1 

SYSOP 

; for 

the sysop 




Ken Morgan 

TWIT 

; for 

poor Ken 




Joe Smith 

NORMAL 

; for 

Joe 





Neither Ken Morgan nor Joe Smith would have to give a password for the barricaded area. 
Instead, their privileges would be automatically set by Opus. The comment field after the 
password is optional, but handy to keep track of who has what access. 
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3.9 Welcome Files 

Opus has a rich assortment of welcome files available for you to bend your mind with. Here's a 
summary: 

• The standard WELCOME file; 

• Custom welcome files (CWFs); 

• Special announcement files (SPANNs); 

• The special OEC file (SPOEC). 

For the particular sequence in which Opus will show these files to a caller, refer to the flowchart 
of the Opus login sequence in section 5 of the Technical Reference Manual. 


3.9.1 The Standard Welcome File 

The standard welcome file is shown to ALL your callers, if you have defined such an file with the 
USES WELCOME option in the Session Section of your control file. 

As this is just a normal OEC file, you can use the Opus Embedded Command set in the file to do 
WAW (wierd and wonderful) things. 


3.9.2 Special Announcement Files 

Special announcement files are shown only to those callers whose records in the Opus user file 
you tweak. There are five "counters" in each caller record for associated special announcement 
files. The counters can be set to show each of the five special announcement files a certain 
number of times (up to a maximum of 255). Opus will then show the caller the corresponding 
special announcement file and decrement the counter by one each time the caller logs on to your 
system. 

To implement this option, you need to define the PATH SPANN option in the System Section of 
your control file to point to the directory in which the special announcement files will be stored. 
The special announcement files are named SPANNn.BBS where "n" is a number from I to 5 to 
correspond with the five counters in each caller's record in the user file. The SPANN file is a 
normal OEC file, so you can use the full set of OECs in it. Here's a sample SPANN file: 


>»> Access Upgraded «« 

as you have correctly answered the Q)uestionnaire, your 
access has now been upgraded to VERIFIABLE member. 

Choose 0)utside from the M)ain Menu, then Mjembership details 
for further information regarding membership. 

TREV. 

(Sysop: Sentry (02) 428-4687 & Sentry's Shadow (02) 418-6682) 
^A 


No, there is more. You also need to set the relevant SPANN counter(s) in the caller's record in the 
user file. You can either use a program called, appropriately enough, SPANN (by Doug Boone) or 
OUFM (the Opus User File Manager by yours truly) to set these counters either globally or for 
specific callers. 







Oput»CBCS Sytop OpToflont Manual 


3.9.3 Custom Welcome Files 

Custom welcome files (CWFs) are shown to individual callers only. The files are shown again 
and again until you delete them, or you can rig up a file which will delete itself using OECs after 
it has been shown. 

For once, you do not have to specify anything in your control file! Instead, there is a special 
format for the CWF file name: the file name is based on the caller's record number in the user 
file. The records in the user file are 1-based (ie, the first record is number 1) to make life easy for 
you. The files have the standard OEC file extension (.BBS -- if you use .GBS you better make 
sure that the caller has the 

The CWFs must be stored in the same directory as the one from which you run the Opus program. 

One last point, you do not need to put a pause OEC in these files as Opus will add one 
automatically at the end of the file for you. 


3.9.4 Special OEC Welcome Files 

Special OEC welcome files (SPOECs) are shown only to those callers you select. There is a field 
in the caller's record in the user file for defining an 8 letter file name without the extension which 
is assumed to be the standard OEC file .BBS/.GBS extension. You can define this file using the 
OUFM (Opus User File Manager) program. 

This file replaces the normal welcome file shown to all callers (ie, the SPOEC file is shown 
instead of the normal welcome file). I have one defined in my user record to bypass the normal 
logon bulletins; although you could also skin this hassle by using privilege level OECs in the 
normal welcome file. If your system is used by a club of some sort, a SPOEC file may be useful 
for showing only club members details of upcoming events. The only limit is your imagination. 
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3.10 The Relogging Function 

If you, or your callers, need to exit Opus to run a particular on-line program, you can relog on to 
the system and end up back at the menu which you exited from without having to go through the 
normal log on procedure! The infamous Opus relog function <ask Doug>. 

To implement the relog fimction you need to set the SECURE, RELOG and AFTER RELOG 
EXIT options in the Session Section of your control file. Go on, refer to section 2 of the Technical 
Reference Manual for details of these options. 

To exit from Opus you need to set up an _OUTSIDE EXIT menu command off one of your menus 
like this: 


OUTSIDE _ Sysop _ "Drop to DOS" = EXIT 15 


and then trap the DOS errorlevel of 15 in your NERF.BAT batch file like so: 


:OPUS 
CHAT 30 
SET PORT=2 
OPUS BBS 


:TEST 

IF ERRORLEVEL 

[. . J 

IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
GOTO ERRORO 


255 GOTO ERROR255 

15 GOTO DOS 
4 GOTO ERROR4 
3 GOTO ERROR3 
2 GOTO ERROR2 
1 GOTO OFFLINE 


:DOS 

NEWBAUD Q:\OPUS\LASTUSOO.DAT 
IF ERRORLEVEL 96 GOTO REMOTE_DROP 
IF ERRORLEVEL 48 GOTO REMOTE_DROP 
IF ERRORLEVEL 24 GOTO REMOTE_DROP 
IF ERRORLEVEL 12 GOTO REMOTE_DROP 
IF ERRORLEVEL 3 GOTO REMOTE_DROP 
IF ERRORLEVEL 0 GOTO LOCAL_DROP 

:REMOTE_DROP 
CTTY COM%PORT%: 

:LOCAL_DROP 

COMMAND 

:RETURN 
Q: 

CD Q:\OPUS 
CTTY CON 
OPUS BBS -O 
GOTO TEST 


and you need to re-run Opus with the -O command line switch. 

IMPORTANT: make sure you define an AFTER RELOG EXIT errorlevel and that the flow of 
your batch file does not keep executing Opus with the -O command line switch or else ... 


> Hi everyone, I've been having this strange problem and I 

> can't figure it out. _ 


... Opus reload will reload itself over and over again after each caller who goes outside. 
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3.11 Expiration Control System 

The optional Opus caller expiration control system allows the termination of caller access based 
on either expiration date or minutes given and used, or both. Since this system operates 
independently of the existing daily time and file download limiting, all three forms of limiting can 
be used in combination. All control settings are made on a per caller basis so you can have a mix 
of callers with different forms of limiting. Additional per-user settings control whether a caller is 
disconnected, demoted, both, or neither. 


3.11.1 Expiration Control Method 

Expiration control may be based on: 


Method 

Description 

Date 

When a caller's ByDate flag is enabled, that caller is "expired" on the 
given expiry date. 

Time 

When a caller's ByTime flag is enabled, that caller Is "expired" when the 
caller has used (debited) as many minutes as the caller was given 
(credited) as shown by the Debit and Credit minutes fields in the caller's 
user record. These fields act in much the same way as the FidoNet 
credit/debit fields do in that they continually accumulate and their 
difference is the actual balance remaining 


You can set a caller's user record for both Date and Time expiry so as to allow the case where you 
want a user to consume their given minutes within some calendar time frame to avoid the case 
where some low activity caller takes 10 years to use the 30 minutes of usage credit. 


3.11.2 Handling Expired Callers 

The way an expired caller is handled is controlled by the AxeUser and DemoteUser flags in the 
caller's record. If neither is set then the caller will only get the relevant warning and/or expiration 
messages (see the section on Implementing Expiration Control below). 

Method Description 

DemoteUser If enabled, the caller's privilege is reset to the expiration privilege 

value In the control file. If that value has not been set, then the caller is 
forced to the lowest privilege (Twit). 

AxeUser If enabled in the caller's record, the caller is rather unceremoniously 
disconnected by Opus. 

Both Demote and Axe can be used together so that you can reduced a caller's privilege level and 
stop the caller from logging on. That may be handy when you want to signal an external 
maintenance utility by setting the privilege level to something unique for further, external 
processing or purging. 


3.11.3 Implementing Expiration Control 

First of all, you need to decide how you are going to implement the expiration control system (if 
at all). 

You can make expiration control automatic for all new callers to your system by defining the 
LOGON XDAYS and/or LOGON XMINS and EXPIRE PRIV options in the Session Section of 
the control file. 
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You may also want to define the EXPIRE DAYS, EXPIRE MINUTES and USES XDWARN, 
USES XTWARN, USES XDGONE, USES XTGONE options in the Session Section of your 
control file. 

The USES XD/XTWARN options allow you to define OEC files to give callers separate 
expiration warning messages for date and time expiry when callers are within a preset number of 
days or minutes from expiration. These time limits are defined with the EXPIRE 
DAYS/MINUTES options. 

The USES XD/XTGrONE options allow you to define OEC files to give callers expiration 
messages for date and time expiry when callers have expired. 

When the caller is within the preset number of days from expiration, the caller would be shown 
XDWARN.BBS at logon. Here is a sample file using the expiration OECs: 


G'day I just thought you should know that your access to 

this system will expire in '^XD days on 


If the current date is greater than or equal to the expiry date you have set, then the caller is shown 
XDGONE.BBS which would typically say: 

» Attention « Access Expiration » Attention « 

'^F'^F, your access to this system expired on '^XC. 

Please bribe the Sysop NOW if you wish further access! 

'^A 


To implement expiration control fo your existing callers, you will need to use OUFM (Opus User 
File Manager) to set the relevant fields in the callers' user records. Refer to the documentation 
that comes with OUFM for further details. 


3.12 "Sections" or "SIGs" 

Each on-line user of a system can be allocated a "section" by the sysop at logon, or can define 
their own section from the section menu if it has been implemented. The ability to choose 
sections from the section menu can, of course, be restricted by privilege level and/or by locks. 

A section restricts a user's access to your Opus system. It is used to allocate message and file 
areas, so that a user will only be able to access those areas which are included in their allocated 
or chosen section. You can look at sections as being something like TBBS SIGs, except that the 
use of sections in Opus is optional. 

Callers could use MSG_NAREA and sections to make Opus operate somewhat like the old CP/M 
Citadel BBS system. When you read all the messages in one area and then go on to the next area 
with unread messages, you only get those areas that you were interested in. 

Or you can look at sections as being something like TBBS SIGs, except that users do not have to 
use them. 


3.12.1 Sysop-defined Sections 

You define the section(s) to which a message or file area belongs in the message or file area 
definition in the control file (BBS.CTL) using the SECTION item. For example, you could setup 
your system to have: 

• an Assembly language section (SECTION AP); 
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• a C language section (SECTION CP); 

• a Turbo Pascal section (SECTION TP); and 

• a Programming section (SECTION P). 


If callers are allocated section P by the sysop at logon, or they choose that section themselves (if 
there is a section menu to which they have access), then they will only have access to those 
message and file areas which have either the P or A or C section set in their area definition (in 
this example, the Assembly, C and Turbo Pascal areas). If callers are allocated section A, or they 
choose that section themselves, they would only have access to message and file areas that have 
the "A" section set in their area definitions (in this example, only the Assembly language area). 


3.12.2 User-defined Sections 

A User Defined Section (UDS) is a section that callers can create on their own. Callers can have 
any combination of up to 80 areas in their section. They can have 1 file area and 79 message areas 
or 40 message areas and 40 file areas, or any other combination. Opus keeps track of how many 
message and how many file areas the caller has selected. 

Although in most ways UDS are just like any other section. User Sections have a couple of 
extensions to be considered, MSG_SCAN, F_NEW, MSG_NAREA, F_LOCATE and the 
NextArea/PriorAreas will no longer be concerned with high message/file area limits. They read 
the area table in the user record directly. 


3.12.3 The Section Menu 


A new addition to the Opus VI.70 menu system is the Section Menu. You do not have to have a 
section menu, it is optional. A sample section menu is set out below: 


% 

SECTION MENU 
_PICK_SECTION Disgrace 
_PICK_SECTION Disgrace 
_PICK_SECTION Disgrace 
_PICK_SECTION Disgrace 
_PICK_SECTION Disgrace 
_SHOW Twit 

_MAIN Twit 

END Menu 


"All areas" = 
"Programming" = PCA 
"LOCAL" = L 
"Buy & Sell" = B 
"Opus" = 0 

"?Help" = C:\Hlp\Sections 
"Quit section menu" 


It is worth pointing out that there is no misprint or typographical error in the first 
_PICK_SECTION menu command -- there is nothing after the "equals" sign. You NEED this 
option if you are going to allow your callers to get out of their sections. Without it, you v^ll only 
cause yourself and your callers grief... as several Beta and Gamma testers can attest. 

To allow callers to set up their own UDS (User Defined Sections) instead of choosing sections 
which have been set up in advance by the sysop, your section menu might look like this: 


% 

SECTION MENU 

_PICK_SECTION 

_MAKE_SECTION 

_MY_SECTION 

_SHOW 

_MAIN 

END Menu 

% 


Disgrace 

Disgrace 

Disgrace 

Twit 

Twit 


"All areas" = 

"Make area list" 

"Use area list" 

"?Help" = C:\Hlp\Sections 
"Quit section menu" 


The _MAKE_SECTION menu command allows callers to add/delete message and/or file areas to 
their section. The MY SECTION menu command then allows callers to select their UDS. It is a 
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good idea to include the "All areas" option so that callers can quickly and easily reset their area 
list to all areas without having to individually add message and file areas. 


3.12.4 Related Control File Options 

There are several options in the Session Section of your control file that you may need to define: 


USES MAKE c:\help\makesec 


This option defines the help file that will be shown before users start making their own user 
defined section or if they press'?' to get help. 


MAKESECTION ABC 


This option defines the section that callers will be dumped into while editing their section. 
Consider that if a user is inside their UDS, they could not add any new areas, because no more 
areas would be available to them! You should define this option. 


LOGON SECTION 


This option defines the section which will be assigned to all new 
callers to your system without sysop or caller intervention. 


USES SECTMENU 


This option defines the so-called "ASCII" menu to replace the "normal" Opus menu. 


SECTION 


This option is not in the Session Section of your control file. Look for it instead in the message 
and file area definitions. It defines the section(s) to which the particular message or file area 
belongs. 

As ever, full details of these control file option may be found in section 2 of the Technical 
Reference Manual. 


3.12.5 Safety Feature 

Sections have a special inbuilt safety feature to protect callers from themselves and you: if a 
caller goes into a section and fails to get into a file or message area for three tries. Opus will drop 
the caller back to the "default" section that you defined in your control file with the 
MAKESECTION option. You _did_ define that option ... better go do it now! 
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3.13 Time Zone Settings 

Internally, Opus always works in Universal Coordinated Time (what was called Greenwich Mean 
Time when grizzled Opus veterans were not so grizzled). You are rarely affected by this. In fact, 
you may not have even realized it until now. Your SCHED.BBS (or whatever name you have 
defined in your control file for the USES SCHEDULE option) file is probably in local time ... so 
you need to tell Opus how to convert the time or you will have to learn to live in interesting times. 

Please find the item (below) that applies to you and put it into your AUTOEXEC.BAT file. 


USA EASTERN 

For standard time. 

For daylight time. 

USA CENTRAL 

For standard time. 

For daylight time. 

USA MOUNTAIN 

For standard time. 

For daylight time. 

USA PACIFIC 

For standard time. 

For daylight time. 

OTHER (STANDARD) TIME ZONES 

Yukon, Canada. 

Alaska. 

Bering. 

Bratislava, Czechoslovakia. 

Sydney, Australia. 

Perth, Western Australia. 


.SET TZ = EST05 
.SET TZ=EST05EDT 


.SET TZ=CST06 
.SET TZ=CST06CDT 


.SET TZ=MST07 
.SET TZ=MST07MDT 


.SET TZ=PST08 
.SET TZ = PST08PDT 


.SET TZ=YST09 
.SET TZ=AST10 
.SET TZ=BST11 
.SET TZ=CET-1 
.SET TZ==EST-10 
.SET TZ=WST-8 


Notes: 

• The 'TZ' means 'Time Zone'. 

• The first three characters are the initials used the time zone 

• The final three characters represent the deviation from Universal Coordinated 
Time (UTC -- blame the French for It not being UCT). 
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4.0 _ The Opus Event System 


Events or... 
things that go bump in the night. 


The first thing you need to understand about how events work in Opus VI .70 is to understand that 
the term "event" is convenient, but sort of misleading in some cases. What we are talking about 
are behaviour windows that modify the default behaviour that you have set in the Opus control 
file. Events, for some fixed period, change the way Opus will work during that period. 

In Opus, you can have an event that runs every day, just weekdays, just weekends, one day every 
week, or every Monday-Wednesday-Friday. Events can also run past midnight. 

You can have as many as 254 events in Opus, or as few as 1. There is no requirement that you 
have an external event every day. The event manager assumes that there is an event 24 hours 
away, and looks for anything closer. If it does not find anything. Opus will just report that the 
next event is 24 hours away and go on, 24 hours later, (assuming there have not been any calls in 
or out to reset the event manager). Opus will just go check the event file again. 

As virtually everyone using Opus 1.03 discovered, Microsoft's time library had a glaring 
weakness when dealing \vith UTC (Universal Coordinated Time, what used to be called GMT). 
Starting with VI. 10, Opus does not use Microsoft's time library. The environment and the DOS 
clock are read directly. 


4.1 Types of Events 


There are seven basic types of event or behaviour window: 


Kind 

External 

Housecleaning 

Mailer 

Matrix 

Scan all 

User 

Yell 


Description 

Halts Opus operations to return control to DOS or a batch file. 
Deletes all those pesky .$$5 files in the outbound mail holding 
subdirectory. 

This event can be used to control whether the Opus internal 
mailer or an external mailer Is used. 

Changes the way Opus handles outgoing and incoming mail 
(often referred to as Z events). 

Forces Opus to scan all Echomail message areas for new 
outgoing Echomail messages. 

Changes the way Opus handles users, giving them more, or 
less, time and download privileges. 

Opus will allow the remote user to request help from the Sysop if 
allowed. 


Some types of event or behaviour window come in two flavours: 

Flavour Description 

Forced These events MUST start at a certain time, and Opus will get Guido to do 
whatever it takes to prevent human users from interfering with the start of 
these events. If for some reason Opus is inactive when a forced event 
should have started. Opus will execute the event as soon as it starts up 
again. 

Informal These events start and end on a more flexible schedule. They do not 
interfere with human callers by limiting the caller's time. Instead, they 
start as soon as Opus is free after the specified start time for the event. 
Opus will execute any informal events that have not run if it has been 
inactive for some reason. 
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The following list shows which events are which flavour (if any): 


Kind 

External 

Housecleaning 

Mailer 

Matrix 

Scan all 

User 

Yell 


Informal 

optionally 

always 

never 

always, unless human callers 

are not allowed on-line 

always 

always 

n/a 


Forced 

optionally 

never 

always 

only when human callers are 

not allowed on-line 

never 

never 

n/a 


4.2 External Events 

External events are used when you want Opus to stop operating and return control to your batch 
file. You can specify external events as being Forced or Informal or you just create an external 
event without declaring it to be either Forced or Informal. In that case the event will affect users 
who log on before the start of the event, but Opus will make no effort to execute the event if it 
was skipped for some reason and is now over. 

There are two inter-relationships between External events and Matrix Behaviour Windows (Z 
events) that should be pointed out: 

• There is a field called an "errorlevel offset" in the Matrix Behaviour Window. This 
offset will be added to the errorlevel from any exit during that behaviour window. 

• The "Exits suppressed" flag In Matrix Behaviour Windows, does not affect 
External Events. It only affects matrix exits such as "Exit after Arcmail" and "Exit 
after Matrix". It is used to prevent your system from performing a matrix exit after 
a mail session (eg you may wish to process all incoming mail once only after the 
end of the zone mall hour so that your system is available for incoming mail for 
the whole hour). 

Generally it is better to make all external events last 0 minutes and either Forced or Informal so 
that Opus will release control to the batch file for the minimum amount of time necessary to 
perform the specified task or whatever. If you give the event some length, and it is completed 
before that time is up. Opus will exit again with the same errorlevel to the batch file over and 
over until the time period specified for the external event has passed. 


4.3 User Events 

User Events are more accurately described as User Behaviour Windows. They allow you a great 
deal of flexibility in how Opus will treat human callers during the time window in which they are 
enabled. 

There are two active fields in a user behaviour window: the Download multiplier and the Time 
multiplier. These fields only affect callers who have a privilege level below ASSISTANT 
SYSOP. SYSOP and ASSISTANT SYSOP are not affected by these behaviour windows. 

A value of "20" is considered to be neutral, users will get exactly what you have specified in your 
Opus control file. A value of "10" in the Time Multiplier would give users 1/2 the amount of time 
specified in the PRM file. A value of 50 in the Download Multiplier would give users two-and-a- 
half times as many kilobytes of download access during the specified time window. 

If you have set your Opus control file so that it reports something like this: 
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DEFINE 

Normal 

Cume 

120 

DEFINE 

Normal 

Time 

60 

DEFINE 

Normal 

File Limit 500 


and you have a user behaviour window with a Download Multiplier of 30 and a Time Multiplier 
of 40, a NORMAL user would get: 


DEFINE 

Normal 

Cume 

120 * 

40/20 

240 

DEFINE 

Normal 

Time 

60 * 

40/20 

120 

DEFINE 

Normal 

File 

Limit 

500 * 30/20 = 

750 


If you had a user event with a Download Multiplier of 0 and a Time Multiplier of 10, a NORMAL 
user would get: 


DEFINE 

Normal 

Cume 

120 * 10/20 

= 60 

DEFINE 

Normal 

Time 

60 * 10/20 

= 30 

DEFINE 

Normal 

File 

Limit 500* 0/20 

= 0 


4.4 Mailer Events 

A mailer event lets you decide when you want to use the internal Opus mailer or an external 
mailer as a "front-end" to your Opus system. 

The external mailer command line is specified in the Opus control file. Whether you want to use 
the Opus internal mailer or the external mailer as your default mailer may also be set in the Opus 
control file. You can then use the mailer event to override the default setting in your Opus control 
file. 

If an external mailer is chosen. Opus loads and initializes itself, and then loads the external 
mailer. When a call comes in the mailer answers the phone. If it is another FidoNet system 
sending mail, the mailer handles everything. If it is a human calling in, the mailer is dropped out 
of memory and Opus takes over. Since Opus is already in memory and initialized this method is a 
lot faster than the way other software deals with external mailers. However, it is memory 
intensive. 


4.5 Matrix Events 

Matrix events are more accurately described as Matrix behaviour windows. They are primarily 
used to control the way outbound calls are made. Should any calls be made? Should they be local 
or long distance calls? How do you define a "local" call? How often should calls be made? 

All matrix behaviour windows are considered to be informal except for those in which the 
behaviour window does not allow human callers. 
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4.5.1 Matrix Event Flags 

Matrix events have seven possible flags. You do not have to set any of them if you do not wish to 
use their functionality. The Matrix event flags and their meanings are listed below: 


Flag 

Mail 

Local-Only 

No-Local 

Continuous-Mail 

Suppress-Exits 

Mail-Only 
Requests 

NO-Out-Reqs 


Description 

Allow outbound calls to placed during this window. 

Only nnake calls that are equal to or below the cost of the local 
cost field 

Only make calls that are above the value stored in the local cost 
field 

Only call those systems in the nodelist that are marked as being 
able to handle continuous incomming mail ("CM" in FidoNet) 

Do not allow matrix exits for packing, unpacking or otherwise 
processing incomming mail. 

Do not allow human callers on-line. Just handle mail. 

Allow file requests to be honoured. (Usually disabled during the 
Zone Mall Hour.) 

Do not allow Opus to make outbound requests. This only works 
with omMM VI.70 and oMAIL VO.41 and above by creating 
special names for the file that forces Opus to make calls. Do 
not send outbound requests during Zone Mail Hour. 


4.5.2 Matrix Event Fields 

Matrix events have 5 possible numeric fields. You do not have to set any of them if you do not 
wish to use their functionality. The Matrix event fields are set out below: 


Local Cost Range; 0-255 

Set the value that will be considered to be a "local" phone call during this event. If you have the 
Local- Only flag set, then only calls to those boards listed in your NODELIST.DAT file that are at 
or below the value stored in Local Cost will be made. 

If you have the No-Local flag set, then only calls to those boards that have costs ABOVE this 
value will be made. 


Error Offset Range: 0-255 

A value that will be added to any exits made during this event. One use would be to pack mail 
with different routing verbs at different times of the day. You might want to pack all local mail as 
HOLD during Zone Mail Hour to keep your board free during ZMH. 


Call-Frequency Range: 5-40 
(5 is more frequent, 40 is less frequent) 

Controls how often Opus will check the outbound mail directory (ie tickle the hard disk unless 
you are running a disk cache) looking for mail to be sent. Opus will not find something every 
time, but it will reinitialize the modem each time. 

The default value is 14. With this setting Opus will place an outbound call roughly every 90 
seconds. With a setting of 5, Opus will try to make a call roughly every 10 seconds, with a value 
of 40, it will be roughly 12 minutes between calls. 
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Request limit Range: 0-255 

Controls the number of minutes that Opus will allow another system to file request from your 
system. Opus will check after each requested file is sent to see if the specified number of minutes 
has expired. If it has. Opus will hang up. Otherwise, Opus will proceed to send the next requested 
file, even if the time it takes to send that file will exceed the total number of minutes specified in 
the request limit. 

The word "roughly" came up in that paragraph a lot. The reason is that the time between calls has 
a random factor of +/-25%. So if you have the default frequency set, the average time between 
calls will be 90 seconds, but it might be as low as 45 seconds or as high as 105 seconds. With a 
value of 40, the time between calls might be as low as 8 minutes and as long as 16 minutes. 

The formula for creating the time to the next outbound call is: 

time = (45 + (rand() % 31)) * call-frequency * call-frequency 


14 * 14 


4.6 Yell Events 

Yell events are used to determine when the sysop wishes to allow callers to page the sysop for an 
on-line chat. If no yell events are specified, then users will be told that yell is disabled whenever 
they choose the Y)ell menu command. 

If a yell event exists, and a caller pages the sysop between the starting and ending time defined by 
the yell event. Opus will cause the speaker on the sysop's computer to beep. The length of this 
beeping can be controlled by using the "errorlevel" field to set the number of seconds for which 
the speaker is to beep. 


4.7 Scan-All Events 

Scan-All events cause Opus to scan all Echomail message areas, except inbound-only areas, for 
new Echomail messages to be scanned out. This only works if Opus is handling Echomail 
processing internally. 


4.8 Housecleaning Events 

Housecleaning events are used to clean out the .$$n files in the Opus outbound mail holding 
directory (or directories if you are using zoned outbound directories. These flag files are 
incremented from .$$1 to .$$5 to prevent Opus from wasting its time and your money making 
unsuccessful calls to systems which connect but do not successfiilly complete a mail transfer for 
whatever reason. If .$$5 flag files are not deleted. Opus would not make calls to those systems 
again. It is therefore a good idea to run a housecleaning event at least once a day, especially if 
your system is a major mail mover. 
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4.9 Overlapping Behaviour Windows 

The end of a behaviour window is considered to be as important as the start of an event, so Opus 
also tracks the end of an active event. Two events of the same kind can overlap. If you have two 
windows that overlap. Event 1 starts at 1:00 and ends at 5:00, Event 2 starts at 2:00 and ends at 
3:00 like this: 












1:00 

2:00 

A 

3:00 

—k 

4:00 

—k 

5:00 


A ' A 


Next event at 2:00, 
Next event at 4:00, 
Next event at 5:00, 


Event 1 is active 
Event 2 is active 
Event 1 is active 


4.10 Advanced Events for Time Travellers 

One neat trick that Opus \vill allow you to use is that events can begin and end in different time 
zones. This can be a lot of help when you are trying to handle mail routing through your lowest 
cost carrier and dealing with FidoNet's Zone Mail Hour. 

For example, Sysop-X (Guido?) has a Matrix Event that starts at midnight local time (0:00 hours) 
and ends at 9:00 UTC (the start of FidoNet's Zone Mail Hour in Zone 1). The next Matrix Event 
runs from 9:00 UTC to 10:00 UTC (Zone Mail Hour in Zone 1) and then another event takes over 
at 10:00 UTC and ends at 6:40 local time. 

Why go through all that? Simple, when Daylight Savings time ends all Sysop-X has to do is reset 
the time on the computer and the TZ environment variable. The events will automatically swing 
around and adjust themselves to either Daylight or Standard time accordingly. 
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This is what Sysop-X's schedule looks like: 


Tag 

Day Start 

End Run Exit 

. Mail LO 

NL CM 

SX MO RQ FR 

000 

Z 

SMTWTFS 

0:00 

L 

9:00 

U 

ENA 



Y 

N N 

Y N N Y 10 

001 

X 

SMTWTFS 

8:59 

U 

8:59 

U 

ENA 

F 

030 




002 

H 

SMTWtFS 

9:00 

U 

9:00 

U 

ENA 




Clean 

Holding Area 

003 

Z 

SMTWTFS 

9:00 

U 

10:00 

U 

ENA 


050 

Y 

N 11 

N N Y Y 20 

004 

U 

SMTWTFS 

10:00 

U 

6:00 

L 

ENA 



User 

event, 

DL=50 Time=40 

005 

Z 

SMTWTFS 

10:00 

U 

6:40 

L 

ENA 



Y 

N N 

Y N N Y 10 

006 

X 

SMTWTFS 

10:00 

U 

10:00 

U 

ENA 

F 

050 




007 

S 

SMTWTFS 

5:45 

L 

5:45 

L 

ENA 




Scan All Echo Areas 

008 

X 

SMTWTFS 

5:46 

L 

5:46 

L 

ENA 

I 

060 




009 

U 

SMTWTFS 

6:00 

L 

8:00 

L 

ENA 



User 

event, 

DL=20 Time=20 

010 

X 

SMTWTFS 

6:40 

L 

6:40 

L 

ENA 

I 

059 




Oil 

Z 

sMTWTFs 

6:40 

L 

18:00 

L 

ENA 



Y 

Y N 

Y N N Y 30 

012 

Z 

Smtwtfs 

6:40 

L 

17:00 

L 

ENA 



Y 

45 N 

Y N N Y 30 

013 

z 

smtwtfS 

6:40 

L 

23:00 

L 

ENA 



Y 

40 N 

Y N N Y 24 

014 

u 

Smtwtfs 

8:00 

L 

18:00 

L 

ENA 



User 

event, 

DL=30 Time=30 

015 

u 

sMTWTFs 

8:00 

L 

15:30 

L 

ENA 



User 

event, 

DL=60 Time=40 

016 

u 

smtwtfS 

8:00 

L 

22:30 

L 

ENA 



User 

event, 

DL=30 Time=30 

017 

Y 

SMTWTFS 

10:00 

L 

21:00 

L 

ENA 




Yell Event 

018 

U 

sMTWTFs 

15:30 

L 

22:30 

L 

ENA 



User 

event, 

DL=20 Time=:20 

019 

Z 

Smtwtfs 

17:00 

L 

22:00 

L 

ENA 



Y 

10 N 

Y N N Y 32 

020 

U 

Smtwtfs 

18:00 

L 

22:30 

L 

ENA 



User 

event, 

. DL=15 Time=:15 

021 

Z 

sMTWTFs 

18:00 

L 

22:00 

L 

ENA 



Y 

10 N 

Y N N Y 24 

022 

X 

SmtwtfS 

21:00 

L 

21:00 

L 

ENA 

I 

055 




023 

z 

SMTWTFs 

22:00 

L 

23:00 

L 

ENA 



Y 

20 N 

Y N N Y 24 

024 

u 

SMTWTFS 

22:30 

L 

9:00 

U 

ENA 



User 

event, 

, DL=30 Time=30 

025 

z 

SMTWTFS 

23:00 

L 

0:00 

L 

ENA 



Y 

40 N 

Y N N Y 12 


000.Make calls Anywhere until ZMH 

001.External event to pack logs before ZMH 

002.Clean out all *.$$? flags in Outbound dir. 

003.Zone Mail Hour, No humans, do not call the local boards 

004.Users get 2+ times download/time 

005.End of Zone Mail hour, early morning Mail status 

006.End of Zone Mail hour. Renumber message areas 

007.This is the Scan All event 

008.Do morning Polls 

009.Users get "normal" time/download 

010.Morning external, unpack MegaList, run POLE_MQ 

Oil.Weekday Mail status, no long distance calls. 

012.Sunday moming/aftemoon Mail status 

013.Saturday Mail status 

014.Users get extended time/dl on weekends 

015.Users Weekday get extended time/download during business hours 

016.Users get extended time/dl on weekends 

017.Daily Yell event 

018.Users get limited time/dl during "prime time" 

019.Sunday 5:00 p.m. Mail. Reach Out America off 

020.Users get limited time/dl during "prime time" 

021.Early evening mail status. Use PC Pursuit 

022.Evening Poll set up. 

023.Reach Out America starts. Call in US, but outside of California 

024.Users get 50% extra 10:30 p.m. to ZMH 

025.Make calls inside California, but no non-USA calls 


4.11 How to Set Up Events 

To set up events in Opus VI.70, the program to use is Doug Boone's OEVENT.EXE Version 0.81. 
It was used to generate the event listings in section 4.10 above. For further details on the 
operation of OEVENT, please refer to the documentation that comes with OEVENT. 
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5.0 _ When the Sysop is at the Keyboord 

n I fU 

Uc C%tt tlxc (yU4Xd‘ 

— Miami Vice 

Opus has four basic modes: 

• When the system is waiting for a call or an event; 

• Sysop "calling" the system from the keyboard; 

• When a caller is on-line; and 

• Chat mode. 

The following sections describe the use of the local keyboard in each of these modes. 


5.1 When Opus is Waiting for a Call 

When Opus is sitting at the "Ready" prompt waiting for your next lucky caller, or the next 
scheduled event or matrix behaviour vvindow, you may: 
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Command 

How to do it 

Description 

Batch File 

Press FI key 

Run Tl.BAT’ in the MISC subdirectory, (see 'botch files’ below) 

Batch File 

Press F2 key 

Run 'F2.BAT' in the MISC subdirectory, (see 'batch files' below) 

Batch File 

Press F3 key 

Run 'F3.BAT’ in the MISC subdirectory, (see 'batch files' below) 

Batch File 

Press F4 key 

Run ’F4.BAT’ in the MISC subdirectory, (see 'batch files’ below) 

Batch File 

Press F5 key 

Run ’F5.BAT’ in the MISC subdirectory, (see 'batch fibs’ below) 

Batch File 

Press F6 key 

Run ’F6.BAT’ in the MISC subdirectory, (see 'batch files’ below) 

Batch File 

Press F7 key 

Run ’FZBAT’ in the MISC subdirectory, (see 'botch fibs' below) 

Batch File 

Press F8 key 

Run ’F8.BAT' in the MISC subdirectory, (see 'batch fibs’ below) 

Batch File 

Press F9 key 

Run ’F9.BAT’ in the MISC subdirectory, (see 'batch fibs’ below) 

Batch File 

Press no key 

Run 'FIO.BAT' in the MISC subdirectory, (see 'botch fibs’ below) 

Call Now 

Press C 

This forces Opus to make an outbound call now provided you have some 
outbound mail to deliver, the current matrix behaviour window and local call 
cost settings allow outbound calls at this time etc. You may have to press C 
several times to attract the attention of Opus. This is normal behaviour. 

Decrease Delay 

Press the CURSOR 
DOWN key 

This decreases the delay between outE)ound mail calls by Opus. The bigger 
the number, the longer the delay is between calls, the smaller number, the 
more often Opus will make calls. It is a manual way to override the 
outbound call frequency you set in the event fib (see Opus Event System 
section of this manual). With a setting of 5 Opus tries to make an outbound 
call every 10 seconds and with a setting of 40, Opus tries to make an 
outbound call every 10 to 15 minutes. 

DOS command 

Press ESCape 

This allows you to enter a DOS command. When the DOS command 
completes, you will be returned to Opus. Opus does not busy out the 
phone line during the lifetime of the DOS command. 

Increase Delay 

Press the CURSOR 

UP key 

This increases the delay between outbound mail calls by Opus. The bigger 
the number, the longer the delay is between calls, the smaller number, the 
more often Opus will make calls. It is a manual way to override the 
outbound call frequency you set in the event fib (see Opus Event System 
section of this manual). With a setting of 5 Opus tries to make an outbound 
call every 10 seconds and with a setting of 40, Opus tries to make an 
outbound call every 10 to 15 minutes. 

Keyboard 

Mode 

Press K 

This lets you log on to your system in 'keyboard mode’. (This is sometimes 
called ’testmode’ by a certain LCD.) See further the keyboard mode section 
below. 

Matrix Menu 

Press M 

This option displays the current matrix behaviour window setting and gives 
you the option of checking the status of outbound mail (Information), polling 
another matrix system (Poll), unpacking any inbound mail bundles (Unpack), 
scan all your Echomail message areas (Scan), clear the ########.$$n fibs 
from your outbound directory or directories (Clear undiabbbs) or return to 
Opus (Quit). While you are in the Matrix Menu, Opus will busy out the 
phone line using the method specified in the control fib (refer to the BUSY 
option in section 2 of the Technical Reference Manual). 

Quit 

Hold down ALT and 
press Q. 

This quits Opus and returns you to DOS. CONTROL-C does the same thing 
and is an alternate keystroke to ALT-Q. 

Yell Event 

Press T 

This forces Opus to follow the scheduled Yell event; 

Yell Off 

Press U 

This overrides the scheduled Yell event and forces Yell OFF; 

Yell On 

Press Y 

This overrides the scheduled Yell event and forces Yell ON; 
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5.1.1 Setting Up FI..FI0 Batch Files 

To run a batch file associated with one of the function keys FI through FIO, batch files with the 
names FLBAT through FIO.BAT must exist in the Opus miscellaneous directory (ie the directory 
defined in your control file with the PATH MISC option). 

FI usually means help, right? (I hope you pass this impromptu test or Guido will ...) Right. My 
FI.BAT file contains the following, which is very usefUl for those of us whose memories are in 
recess: 


©echo off 
els 
echo 
echo 

echo Function Key Batch Files 
echo 

echo F 1 
echo F 2 
echo F 3 
echo F 4 
echo F 5 
echo F 6 
echo F 7 
echo F 8 
echo F 9 
echo FIO 
echo 


This help summary 

Run User File Manager 

List Opus.log 

List disk cache stats 

Drop to DOS, busy line out 

Run Event Manager 

Run Opus-Fam 


A "skeleton" or "generic" batch file which may be used to implement the other function key batch 
files is set ut below with comments (do not enter the comments if you decide to use it!): 


©echo off 

at com%PORT%: hi 

<program name> <parameters> 

at com%PORT%: hO 

goto end 

:END 

c : 

cd \opus _ 


;avoid screen clutter DOS 3.3+ 
;busy out the phone line 
;insert your program etc here 
;hangup the modem 
;just to be safe 


• AT is a small program which sends AT commands to your modem; if you do not 
have this program (stocked by most BBS file areas) you may be able to use: 
ECHO ATH1 > COM1: and ECHO ATHO > COM1: 

• %PORT% is a DOS environment variable containing the communications port 
which is used by Opus on the system invoking the batch file (very handy if you 
are running a multi-line system). You can set it by placing SET PORT=1 (for 
com1:) in your NERF.BAT batch file; alternatively you can simply hardcode the 
entry in the function batch file like so: AT COM1: HO and AT COM1: H1 

• <program name> inserting COMMAND here will let you drop to DOS and busy out 
the phone line. 


62 







Opm^CBCS Sytop OpToflont Manual 


5.2 Sysop ^Xalling^^ from the Keyboard 

When Opus is sitting at the "Ready" prompt waiting for a call or the next scheduled event, the 
sysop can log on to the system by pressing K. Opus will ask you to confirm it is you, will ask for 
your password etc and then log you on to the system. 

The keyboard works just like it would if you were calling in using a modem. There is only one 
primary difference. When Opus asks for your name, you can quickly get back to DOS by just 
pressing ENTER. You can also terminate Opus <ouch> and get back to DOS by typing ALT-X 
from anywhere inside Opus (this also works remotely. Opus will log you off without asking you 
any questions at all, if you are using Avatar emulation to transfer ALT keys over the modem line - 
- see further below). 

A few things are different. If you find that Opus is not listening to your every keystroke when you 
try to abort searches and listings, and you have VIDEO IBM set in the Equipment Section of the 
control file, change it to VIDEO DOS and Opus may just pay more attention to your pounding on 
the keyboard. Also note that if you have IBM VIDEO set, any Avatar or ANSI full-screen video 
emulation commands will be written straight to the screen ... not a very pretty sight unless you 
have honed your skill to translate these commands on the fly. 

In keyboard mode OpEd, the Opus full-screen editor, accepts additional keyboard commands as 
follows: 


Key 

Action 

ALT-R 

Open a quotation window 

ALT-Q 

Copy four lines of quotation into reply 

ALT-X 

Abort message 

ALT-W 

Save message 

+ 

Copy four lines of quotation into reply 

TAB 

Insert mode; insert 8 spaces. 

Overwrite mode: overwrite 8 characters. 

PgUp 

Scroll message up 

PgDn 

Scroll message down 

CUP 

Cursor up 

CUD 

Cursor down 

CUL 

Cursor left 

CUR 

Cursor right 

HOME 

Move cursor to beginning of line 

END 

Move cursor to end of line 

INS 

Turn insert mode on 

DEL 

Delete character under cursor 

F1 

Help screen 

F10 

Editor Menu 


If you call your system remotely and have Avatar emulation turned on, and are using a proper 
Avatar terminal emulator (such as TinyTerm or FrontDoor), you can transfer those keys over the 
phone line and use them in OpEd (to use OpEd you need at least an 80x25 screen and screen 
clear turned on). To allow this transfer, press ScrollLock in FrontDoor, or Shifl-Fl in TinyTerm, 
which will tell these programs to transfer any function keys remotely. The same key that turns this 
feature on in these two terminal programs turns it off. 


5.3 When a Caller is On-line 

When a caller is on-line, there are two different keyboard modes available; (1) the sysop can type 
commands as if the caller had typed them, and (2) the sysop can obtain information about ^e 
caller and change some of it while the caller is still on-line — Opus will remember any changes 
made for next time the caller logs on. 
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The full list of keyboard commands available while a caller is on-line are set out below; 


Key 

Action 

<up Qrrow> 

Add 1 minute to the caller's time 

<down Qffow> 

Subtract 1 minute from the caller’s time. 

C 

Go into chat mode (see below). 

CONTROL-X 

Ignominiously hong up on the collerl 

A (or CONTROL-A) 

Turn on the local keyboard. Opus will take commands from your keyboard or from the modem, 
but your keyboard had priority. 

<ESC> 

Turn off the local keyboard. 

- (’minus’) 

Lower the privilege level of the caller by one notch. Starting with Opus V1.70, this also changes 
the caller’s time and download allowances to reflect those associated with the new privilege 
level for this call. 

+ (’plus’) 

Raise the caller’s privilege level by one notch. Starting with Opus V1.70, this also changes the 
caller’s time and download allowances to reflect those associated with the new privilege level 
for this call. 

O (or CONTROL-O) 

Turn off SNOOP. Only status-type messages appear on your monitor when the SNOOP is 
turned off. 

N (or CONTROL-N) 

Turn on SNOOP mode. Your monitor will show everything that the caller’s monitor shows. 

Z 

Zero the cumulative daily time for the caller. This has NO EFFEG on the time for the current call 
... only the total time spent on-line for the day. Use <up> and <down> to change the caller’s 
time limit for the call that is in progress. 

? 

Show a detailed chart of information about the caller (eg keys, user macros, number of calls, 
time on-line today, file up/down loads etc, whether chat was requested). 

K 

Display the caller’s keys. You can then toggle keys on or off by pressing those keys that you 
want to toggle on or off. This will cause the keys to redisplay. The caller’s current keys are 
shown in upper case, the other keys are shown in lower case. Press ENTER to finish toggling the 
keys. 

Y 

Override the scheduled Yell event and force Yell ON; 

U 

Override the scheduled Yell event and force Yell OFF; 

T 

Force Opus to follow the scheduled Yell event; 

FI (Niel Key 1) 

Send F1.BBS or Fl.GBS 

F2 (Niel Key 2) 

Send F2.BBS or F2.GBS 

F3 (Niel Key 3) 

Send F3.BBS or F3.GBS 

F4 (Niel Key A) 

Send F4.BBS or F4GBS 

F5 (Niel Key 5) 

Send F5.BBS or F5.GBS 

F6 (Niel Key 6) 

Send F6.BBS or F6.GBS 

F7 (Niel Key 7) 

Send F7.BBS or F7.GBS 

F8 (Niel Key 8) 

Send F8.BBS or F8.GBS 

F9 (Niel Key 9) 

Send F9.BBS or F9.GBS 

FIO (Niel Key 10) 

Send F10.BBS or FIO.GBS 

<unknown key> 

If you press any other key, you will be shown a short status screen and a brief menu of some 
of these commands. 


The Niel-Key are sometimes called "function keys" by those who do not live in Dallas.^ The 
Niel Keys are a set of keys that work like photon torpedoes. You can send any one of ten OEC 
(BBS/GBS) files to the caller at the press of a button ... which means they can have ANSI full¬ 
screen video and OECs to do everything from greet the caller with the caller's own name, send a 
quote of the day, or even hang up on the caller (or all of the above). The FI.BBS / FEGBS) files 
must be located in the Opus miscellaneous directory which is defined in the control file with the 
PATH MISC option. / 


^Niel was a harmless but completely annoying caller in Dallas a few years ago. All the sysops here 
would sit around at pizza parties and think up dirty tricks to play on him. I simplified the process by 
letting sysops put their meanness into .BBS files. The best one started by disabling CONTROL-K (user 
command to break out of a .BBS file). That was followed by about 4K worth of CONTROL-Gs (ring the 
user's bell). It was topped off with a CONTROL-NIEL (the OEC that hangs up on the caller). So, Niel 
has been imortalized. See what happens when you annoy the wrong crowd of sysops? <sly grln>-Wynn 
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5.4 Chat Mode 

Starting with Opus VI. 10, chat mode is only available if you have loaded George Stanislav’s "chat 
fossil" (a small Terminate and Stay Resident program) or you are using one of the several external 
chat programs which are available (eg William Beebe's OPHONE) via an external menu 
command. 

The chat fossil should be loaded from the NERF.BAT batch file which you use to start Opus. 
Load it just after the point that you load your fossil. If you run DESQview and load your fossil 
outside of DESQview, then load the chat module outside also. 

To chat with a caller is who on-line, simply press C. To end chat mode, use ALT-Q. 


4.5.1 Configuring the Chat FOSSIL 

You can configure CHAT.COM to slow down between the individual beeps. CHAT uses a very 
simple method of waiting between the beeps: it loops so many times. The default it uses is a 4.77 
MHz PC. On any faster computer this is not the way to go! To slow it down, simply place a 
number on the command line. 

EXAMPLE, on a 80386SX-16 computer: chat 30 

This tells CHAT to repeat the loop 30 times. Play with the value till you find one that suits your 
particular system. 


6.0 

C6 tUc erf 

“ Guido Palermo^ 
Opus Bylaws and Covert Action Connnnittee 


The Matrix 


This is a general explanation of the procedures involved in setting up your system to send 
messages from your system to other systems in the Matrix. It assumes that you have followed the 
procedures outlined in the section in this manual entitled "Setting Up Opus VI.70" — if you have 
not followed those procedures exactly, this section may not be of much help to you. 

Skip this section if you do not want to run netmail ... there is no rule that says you have to run 
netmail. 

Uhuh, I thought you might... read on then. 


^Actually, Guido just claims this quotation. When I checked, the quotation's serial number had been 
filed off... so it's impossible to tell for sure. On the other hand, people who stay healthy don't confront 
Guido with stuff like this. 
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6.1 Netmail for the Complete Novice 

This section is dedicated to the sysop who has no previous experience with netmail. If you follow 
the step-by-step instructions, you will quickly set up simple node-to-node netmail. This does not 
cover netmail comprehensively, but it will get you up and running without a lot of frustration. 
Advanced netmail topics will be covered in other sections of the manual. Echomail is also dealt 
with in its own section of this manual. 


The novice's introduction to the Matrix can be overwhelming, especially with all the jargon and 
programs that abound. 



region 
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NODES 


PARSELIST 
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CD 
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ui 

n 

> 

5 
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No wonder it is confusing! Unfortunately, no single source of documentation or information 
covers it all. 


6.2 Files Required for Netmail 

If you check out an active Opus-CBCS, you will undoubtedly see many programs for doing all 
kinds of wonderful and interesting things. However, we are trying to save time and get you going. 
So here is a list of only the essentials that you will need: 


oMMM originally by Wynn Wagner III 

oMMM stands for the Opus Matrix Message Masher. This program is used to bundle messages 
for sending to other systems in the Matrix. You can use other similar programs which bundle 
messages, but oMMM was specifically written to support Opus and has some Opus-specific 
widgets that may not be found in other similar programs. 


NODELIST 

This is your "phone directory" of other systems in the Matrix. It contains information about each 
system's name, location, sysop, maximum baud rate and special information on operating times 
and types of mail that can be processed. 

The nodelist will be in a file named something like NODELIST. 107 (the 107 mean?, it was 
published on the 107th day of the year). The file is usually found compressed inside an archive 
that will have a file extension something like .A07 (ie the first digit of the raw nodelist's file 
name extension becomes an A to indicate that file is ARChived); such a file will need to be 
uncompressed before it can be used. 

The nodelist is published weekly by the FidoNet International Coordinator and available from 
most FidoNet bulletin board systems. Ask your local, friendly, FidoNet sysop if you cannot find it. 
In fact, it may pay to make ^ends with a local sysop because the file is currently over half-a- 
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6.3 


megabyte in size when archived, and just under one megabyte when unarchived. Downloading the 
nodelist at 2400 bps is not exactly high on the fun scale. 


OPARSE by Doug Boone 
PARSELST by Bob Hartman 

The programs are used to "compile" or "translate" the raw NODELIST data into a form usable by 
Opus. They both do the job. You can use either one. 

For example, the program will strip the area codes from local phone numbers. The program can 
also process a per-message "cost" item. This is the amount you would charge your users for 
sending a message, should you decide to give them access to the Matrix message area. Opus will 
use the "cost" information to decide whether a call to a remote system is local or long-distance. 

OPARSE will generate the advanced Opus VI.70 Version 7 nodelist files; PARSELST will 
generate the "old" Version 6 nodelist files used by Opus l.lx and some other mailer programs. 


ARCAXOM by Vernon D. Buerg 

Used to create compressed mail bundles. 

Do not substitute any file compression program that creates compressed files differently from 
ARCA without the prior approval of all of the other systems to which you intend sending mail 
bundles. ARCA is the lowest common denominator in file compression which is supported by 
every Matrix system. 

Other file compressors are probably better, and you will undoubtedly be using them. But ARCA 
is the standard. You should use such things as .ZIP files only with prior arrangement with the 
other system. 


ARCE.COM by Vernon 0. Buerg 

Used to uncompress mail bundles from other systems which have been compressed with ARCA 
or another compatible file compressor. 


OEVENT.EXE by Doug Boone 

The Opus Event Manager which you use to setup events, or often more accurately described as 
behaviour windows, which affect how Opus will operate. 


An Overview of Netmail 

Most novices are quickly conftised by the complexities of netmail, but would appreciate a simple 
overview. The following flowcharts show what happens to incoming and outgoing mail bundles 
and which programs operate on them. Note that once your nodelist is compiled, only four 
programs are required to handle all forms of node-to-node mail: OPUS, ARCA, ARCE, and 
oMMM. 


Figure 6.3-1 

The incoming mail bundle 

+-+ 

! <Incoining mail bundle> ! 

+--I- 

I 
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j 

+-+ 

j OPUS (Matrix session) I 

+ - + 

I 

I 

j 

+ - + 

! Is mail bundle compressed? I 


Yes No 

I I 

+-+ 


ARCE 

(decompressor) 



! OPUS 

! (inbuilt message unpacker) 

! <Bundle is now broken into individual messages> 


+-+ 

j 

I 

I 

+-+ 

! [Matrix Message Area] j 

+-+ 



Figure 6.3-1. The outgoing mail bundle 
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6.4 Quick Start to Netmail 


We Interrupt This Document For A Word From Our Sponsor... 


What follows is a step-by-step chart of the things you need to do in order to get 
hooked into what we call The Matrix. 

The hardest two things about running a bulletin board are (l)getting everything set 
up correctly when you first put the system on-line^ and (2)getting everything set up 
correctly when you first plug into The Matrix. Running the system is a piece of cake. 
Unfortunately^ you get the two hardest steps first. 

If you are new to Opus and sysop^ing^ you should {ust relax and run your new BBS for 
a few days or a few weeks without lumping into everything at once. The Matrix will 
still be there when you are comfortable with running your BBS. 

The Matrix is more intricate than complicated. It has about a zillion little pieces^ but 
none of the pieces is difficult to understand (if you think of each as a little piece). 
You^ll only get into trouble when you try to think of all the pieces of The Matrix at 
once. 

These step-by-step instructions take you through a really basic way of getting 
access. Also, there are probably ways to send only messages addressed to left- 
handed females in cities with an on Thursdays when the date is evenly-divisible 
by 7. But... maybe we should do the basics first. 

Between you and me (and please don^t tell anybody I said this), I think most sysops 
make The Matrix a great deal more intricate than it needs to be. My own system is 
very similar to what you will have when you finish these instructions. To me, 
everything else is goop. 

This is appears to be a singularl opinion. When I first released oMMM, it understood 
about four routing words: SEND, CRASH, HOLD, and DIRECT. Those are all I needed. 
Those are all anybody needs, in my humble opinion. Almost everybody else on the 
planet thought otherwise. Today oMMM has a rich vocabulary and can do all sorts 
of varieties of things. Other netmail widgets are about the same way. You can use 
all the widgets, if you want. To me, the new tools complicate rather than enhance. 
It^s lust one personas opinion. When you get into the details, I (ust wanted you to 
know it is possible to keep The Matrix simple and still lead a meaningful life. 

The instructions you are about to go through are very precise and carefully thought- 
out. It^s best if you take them slowly and make absolutely-positively sure that you 
get each step correct. The reason is simple: you will be dealing with long distance 
charges and with other sysops. 

• The sysops with whom you will be sharing files would appreciate it if you don^t 
break The Matrix. They will also be happy to help you through any difficulties! 

• Your spouse or domestic partner will appreciate it if you don^t do something 

to cause the modem to call Nepal and leave the phone off the hook for 12 hours. 

KEEP IT SIMPLE and you^ll do fine. The Matrix is unbelievably exciting. 

So, buckle up ... you^re in for one hell of a ride. _ 
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This section will list each step required to get node-to-node netmail working. It is a "cookbook". 
Rather than attempt to explain it all here, some assumptions are going to be made to keep it 
simple. You may wish to change things later. To get your system up and running quickly, the 
following assumptions have been made: 

• your system has at least 256k memory available to run Opus; and 

• your Opus system directory is C:\OPUS. If it is not, you will need to substitute 
your own directory pathname in the following instructions. 

Here are the fifteen steps to Netmail: 

1. Place the following programs and files in your Opus system directory (usually 
C:\OPUS where OPUS.EXE resides): 


OPUS.EXE 


ARCA.COM 

BBS.CTL 


ARCE.COM 

OMMM.EXE 


NACL.EXE 

OMMM.CFG 


NACL.HLP 

OEVENT.EXE 


NACL.MSG 

OPARSE.EXE 

= or=' 

PARSELST.EXE 


The Latest NODELIST.??? file 


2. Edit the PARSELST or OPARSE control file (PARSELST.CFG or OPARSE.LST) 
to represent your phone costs and local area code (see the documentation 
included with the PARSELST or OPARSE program). 

In the PARSELST.CFG file make sure you set the following options for Opus 
V1.70: 


; Stuff everyone 

should have: 

Node 3:711/401 

; Your network address 

Country 61 

; Your country phone code 

MaxBaud 9600 

; Your highest baud rate 

; For Opus VI.70 

use the following: 

Complete 

; Generate entire nodelist 

UseZone 

; Do not change Zone to Region 

Version6 

; Generate Version 6 format files 


3. Compile the nodelist by running OPARSE or PARSELST. 

4. Create the following directories: 


C:\MSG\NET\.where the individual messages are stored 

C:\FILE\NET\.where inbound files are stored 


C:\OPUS\OUTBOUND\..where outgoing message bundles are stored 

NOTE: if you are going to be sending netmail directly to different Zones (ie, not 
routing it via the zonegate systems), you need to also create a 
C:\OPUS\OUTBOUND.ZZZ directory for each Zone to which you will be sending 
mail. The .ZZZ is the hexadecimal number of the Zone, so Zone 3 is 3, but Zone 
16 is 10. 

IMPORTANT; If you do create additional "zoned" outbound directories, make sure 
that they appear in your directory in order or else you will experience some grief 
to put it mildly (just ask Paul "I've broken it, Doug" Kelly). Watch out for disk 
defragmenters which order directory entries alphabetically! 
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5. There are several options in your Opus Control File which nnust be set in order to 
handle netmail. These options appear in two sections of the control file, 
"Equipment Section" and "Matrix and Echomail Section". Since this section is 
devoted to the novice, ail non-essential advanced options will be skipped. For full 
details of these control file options, refer to section 2 of the Opus Technical 
Reference Manual. Edit your Opus control file (named BBS.CTL) as follows: 

The Equipment Section 


OUTPUT COMl: 

If your modem is attached to COM2: substitute that for COM1: here. 

BAUD MAXIMUM 2400 

If your modem goes faster, substitute its top speed here (typically 19200 or 38400 
for high speed modems). 

INIT ATZI 

The character string for Opus to send to your modem to initialise it. You should 
place any commands required to setup your modem in the batch file which runs 
Opus and store them in your modem's non-volatile memory using the AT&W 
command. If your modem does not have non- volatile memory (i.e., it does not 
remember settings when you turn the power off) you will need to put your full 
Initialisation string here. 

DIAL PREFIX ATDT 

The character string for Opus to send to your modem before the phone number to 
cause it to dial out. If your phone only supports pulse disling substitute ATDP for 
ATDT. This is where you could add any special characters required for ALL 
outbound calls. For example, "ATDTO,," to go through a PABX and obtain an 
outside line. 

DIAL SUFFIX I 

The character for Opus to send after the phone number. Usually just a return, 
represented by the "|" character. 

MASK CARRIER 128 

Refer to the Opus Technical Reference Manual if you must know what this 
means. 

MASK HANDHSHAKING CTS 

May be required for high speed modems or modems that can accept data faster 
than they send it PROVIDED you have setup your modem to use "hardware flow 
control". 

SEND BREAK TO CLEAR BUFFER 


Comment this line out by placing the percent (ie "%") character in front of the line 
unless you have an HST modem and have set its registers up using the &Y0 
command. 
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SLOW MODEM 

If you have a fast computer (286 or better), uncomment this line to make Opus 
put a tiny delay between characters which it sends to the modem even if you 
have a fast modem. 

The Matrix and Echomail Section 

ADDRESS 

This is essential for sending/receiving netmail. You are normally assigned a 
number by a coordinator for your region or net. Information on coordinator 
locations is located in the nodelist. Before you are assigned an official number, 
you should use as your address. Other local sysops can temporarily 

patch your phone number into their nodellsts until you have an "official" address. 

PATH NETINFO C:\OPUS\ 

Tell Opus where to find your nodellst files. 

USES VERSION 6 

If you are using OPARSE, comment out this line if it exists by placing a percent 
sign (ie %) character in front of It. 

PATH OUTBOUND HOLD AREA C:\OPUS\OUTBOUND\ 

Tell Opus where to store outgoing mail bundles. This directory can be anywhere 
you want, but the one shown is recommended. Some programs will use this 
directory as the default outbound. 

PATH INBOUND MESSAGES C:\MSG\NET\ 

Tell Opus where to store incoming messages. The directory can be anywhere you 
want, but it should be the message area you declared as being Matrix. 

PATH INBOUND FILES C:\FILE\NET\ 

Tell Opus where to store files that are sent to you by other systems. 

SEND LOCAL 

Opus will only send mail to "local" cost nodes unless you override this behaviour. 

AFTER ARCMAIL EXTRACT PACKETS 

Tell Opus to extract messages from incoming compressed mail files 

MESSAGE EDIT ASK CRASH SYSOP 

MESSAGE EDIT ASK FILEATTACH SYSOP 

MESSAGE EDIT ASK UPDATE SYSOP 

MESSAGE EDIT ASK KILLSENT SYSOP 


Tells Opus to ask you about which message attributes you wish matrix messages 
you create to have. 


Message Areas Section 

Create a matrix message area definition in the Opus control file. It should 
reference the directory C:\MSG\NET\ and the message type should be "Matrix". 
Here is a sample Matrix message area definition with just the bare essentials: 
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AREA 0005 

MATRIX 

% 

Area number and name 

MATRIX 


% 

Matrix type message area 

ACCESS PRIV 

Extra 

% 

Access to the area 

EDIT PRIV 

Sysop 

% 

Access for E)nter & R)eply 

PATH C:\MSG\NET\ 

% 

Path to matrix message area 

TITLE Netmail 


% 

Title for this message area 

END AREA 


% 

End of area definition 


6. Use NACL to compile your now modified BBS.CTL control file. NACL will produce 
a file called BBS.PRM which is the compiled version of the Opus control file. To 
compile your control file type the following line and press ENTER: 


NACL /L /V /I BBS > REPORT 


If there are any problems with the compilation of your BBS.CTL file, error 
messages listing the line numbers of the problem lines may be found in the file 
REPORT which is created using the above NACL command line. Use the error 
messages to track down the problem(s) and fix them; then recompile. 

7. Make sure you have loaded your FOSSIL program by running the program (eg 
OPUSCOM1.COM, OPUSCOMM.COM^O or XOO.COM) =or= by installing your 
FOSSIL device driver by putting a "device-' line in your CONFIG.SYS file in the 
root directory (c:\) of your boot drive and rebooting (eg DEVICE=C;\XOO.SYS)^^. 

8. Run Opus by typing OPUS BBS and pressing ENTER. 

9. If you created the default event schedule with OEVENT.EXE, Opus outbound 
netmail behaviour should default to the settings In your control file. To confirm 
this is true, go to the Matrix menu (press "M" at the ready prompt while Opus Is 
waiting for a call). Select the l)nformation option. At the top of the screen it should 
say: "Matrix Behavior: LOCAL" 

10. Test the integrity of your setup by selecting the M)atrix menu (press M while Opus 
is sitting at the ready prompt) and then choose the P)oll option from the menu to 
call a known node in your local area. This part is really satisfying if everything 
works correctly. If it does not work, pay attention to any error messages which 
might hint at the problem, and then recheck everything. 

11. Terminate Opus by pressing ALT-Q. Now edit the oMMM configuration file to 
reflect your system (refer to the documentation Included with oMMM for further 
details of the options in this file). The following is an example of a very simple, 
working oMMM.CFG file: 


; this is line one of the file oMMM.CFG 
; path to your matrix message area 
MESSAGEPATH c:\msg\net 

; path to your outbound message holding area 
; only specify your primary outbound path 
HOLDPATH c:\opus\outbound 

; Matrix address of system. 

ADDRESS 65535:65535/65535.0 ;equivalent to -1:-1/-1.0 

; Define the program for creating compressed mail packets. 
Define_Stuffer ARC area 

; this is the last line of the file oMMM.CFG _ 


IOqPUSCOMI and OPUSCOMM are by Bob Hartman 
1 ^XOO.COM and XOO.SYS are by Ray Gwinn 
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Run oMMM (type oMMM and press ENTER) and see if it terminates with any error 
messages. If it does, it will usually tell you the line number of the line in the 
oMMM.CFG file where the problem occurred so that you can correct it. You can 
ignore its complaint that there is no route file; you do not need one for the 
moment (refer to the oMMM documentation for details of the route file if you are 
curious). 

12. Log on from the keyboard (type K at the ready prompt while Opus is waiting for a 
call). Enter a message in your Matrix mail area to a sysop of a local node, 
preferably one running Opus that can accept mail at any time. Mark the message 
as "Crash" (Answer YES to the CRASH question). After logging off, terminate 
Opus with ALT-Q and then run oMMM. oMMM will move any messages you have 
created in your matrix message area to the outbound holding area. Look for a 
screen report that it Is processing the message. 

13. Re-run Opus (OPUS BBS). Select the M)atrix menu (press "M" when Opus is at 
the ready prompt waiting for a call) and choose information; it should show your 
message In the outbound area, waiting to be sent. After Q)uitting the M)atrix 
menu. Opus will wait a few minutes, then attempt to send the message. If you are 
anxious, you can select the C)all option from the keyboard. You may have to 
press C several times to get Opus to pay attention. This will make Opus peek in 
the outbound holding area and send the mall immediately, regardless of cost. 
You can try it again with a file attached. Just attach a file when entering a 
message in the Matrix message area. 

14. Test your ability to receive and unpack mail by having a local sysop send mail 
and files to you. If everything is working correctly, you will see it come in. If Opus 
does not unpack it automatically, choose the M)atrix menu, select U)npack and 
the mail bundle will be unpacked and the message(s) placed In the Matrix 
message area for you. Log on from the keyboard and verify the message(s) made 
it there. 

15. Create a batch file, NERF.BAT, to run Opus and automate the bundling of mail by 
oMMM. The following is a very bare bones example NERF.BAT batch file which 
will handle mail bundling automagically (the file consists of the lines between the 
two lines of "======", with each line starting in column 1): 


C: 

CD \OPUS 
:OPUS 
OPUS BBS 
:TEST 

IF ERRORLEVEL 16 GOTO BUNDLE 
IF ERRORLEVEL 1 GOTO OFFLINE 
:BUNDLE 
OMMM 

GOTO OPUS 
:OFFLINE 


6.5 Opus Default Netmail Behaviour 

Opus can be configured in many different ways to accommodate the many variables in netmail as 
well as your own preferences. Some of the variables in netmail are: 

• your own system configuration - see the BBS.CTL file and refer to section 2 of the 
Opus Technical Reference Manual; 

• cost of outgoing phone calls - refer to the documentation for your nodelist 
compiler program for setting call costs, and to the section 4 of this manual on the 


75 









Oput-CBCS Sytop OpTotloin Manual 


Opus Event System for setting the cost of what are to be regarded as "local" 
calls; 

• scheduling mail traffic to conform to local, national or International mall schedules 
(eg Zone mail hours) - refer to section of 4 this manual describing the Opus event 
system and to the oMMM documentation which describes routing; 

• the display of various attributes associated with a netmail message while reading 
messages in Opus - refer to the BBS.CTL file and to section 2 of the Opus 
Technical Reference Manual; 

• the ability to define various attributes of a netmail message. 


6.5.1 Behaviour Windows 

Doing outbound mail with Opus is fairly simple. In fact, getting that message across has been one 
of the toughest jobs. 


Idea #1: With Opus, "mail events" do not exist. Instead, there are matrix "behaviour windows." 


With an event, you have to give every detail ... making statements that are procedural in nature. 
With a behaviour window, you paint with a wide brush telling the system what to do with 
different classes of remote system. 

When systems could handle Matrix mail only during special times, routing and times were 
important. Now that most systems can process mail at any time, the idea of a schedule becomes 
less important. 

The item of prime importance in Opus is COST. We are going to try to relieve you of the tedious 
details of scheduling and concentrate on doing things for the least cost. More on this later. 


6.5.2 Building Mail Bundles 


I Idea #2: A "bundle" is what some other systems call a "packet." 

In network operations, a packet has a special meaning ... a meaning that has nothing to do with 
network mail. An "Xmodem Block" is a packet in network terminology. To avoid confusion with 
an established word. Opus documentation use "bundle". 

With some programs, bundles are built every time a mail schedule starts. As a result, one 
message may be put into a bundle several times. With Opus, bundles are built once. As Opus has 
no internal bundler (the thing that maintains message bundles destined for some other system) 
you must use an external program called oMMM (Opus Matrix Message Masher). You can exit 
Opus with a preset DOS errorlevel to call the bundler program when the contents of the Matrix 
area changes (refer to the AFTER EDIT EXIT <number> line in the Opus control file). 


^^This seems incredibly simple, but until Opus slashed the processing of matrix traffic down to almost 
nothing, processing messages was really time-consuming and caused lots of wear on hard disks.—Wynn 
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6.5.3 File Names ^^Drive'’'' Outbound Mail 


Idea #3: The driving force behind outboxmd message and file traffic is file names! 


You will have special subdirectories set aside just for bundles and other Matrix files. These 
subdirectories belong to Opus and should not have anything else put in there. Opus will maintain 
these subdirectories for you. 

As soon as you run oMMM, messages that are marked KILL/SENT in your Matrix message area 
will disappear. They have not been sent, yet. They have just been bundled up and deposited in 
your outbound mail holding area, ready to go. 


Bundle file names 

The file names of the bundles tell Opus how to treat the different bundles. Here is a typical 
bundle name: 


12345678.OUT 


That says the bundle is for 1234/5678. The numbers are in hexadecimal (base 16). The ".OUT" 
means it is a regular bundle and, if left with that extension, will be treated by Opus like a .DUT 
file (see below). 


Extension 

.CRT 

.CUT 

.DRT 

.DUT 


.DUT 


.HRT 

.HUT 

.ORT 


Meaning to Opus 

the same as CUT but with an attached file request; 

send the bundle to the destination node NOW, regardless of cost; 

the same as DUT but with an attached file request; 

send the mail direct to the other node without routing it via another 

system; if the destination node can accept CM (Continuous Mail, le, mall 

at any time) send it now provided there Is no Opus behaviour window 

overriding this directive (eg local call cost is observed - see further the 

section 4 of this manual on the Opus Event System); 

send the mail direct to the other node without routing it via another 

system; if the destination node can accept CM (Continuous Mail, ie, mall 

at any time) send it now provided there is no Opus behaviour window 

overriding this directive (eg local call cost is observed - see further the 

section 4 of this manual on the Opus Event System); 

the same as HUT but with an attached file request; 

hold the bundle for pickup by the destination node; 

the same as OUT but with an attached file request. 


One nice thing is that you can manually change the file name's extension if you need to do so. 
That would change the behaviour of the bundle the next time Opus sees it. Only change it if you 
know what you are doing! 

The oMMM program knows about these extensions and creates them based on information you 
put into the oMMM route file. You will have statements like this: 


ONEHOLD 1:119/5 


That would create a .HUT bundle file of messages addressed to 1:119/5 that are to be HELD for 
1:119/5 to pickup when it calls. 


^^This Is interesting stuff, 
everything in this section. 


If you are a novice sysop, it's probably okay if you don’t understand 

—Wynn 
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Flow File Names 

Files are also sent through the Matrix. oMMM builds and maintains a file that tells Opus what 
files to send to destination systems and what files to hold for pickup by destination systems. A 
typical "file attach" file might be named: 


12345678.FLO 


The flow file extensions are: 

Extension Meaning 

. FLO regular 

. HLO hold these files for pickup 

. CLO crash these files to the other system now, regardless of the cost! 

.DLO send these files if the destination is capable of receiving CM 

(Continuous Mail, i.e., can accept mail at any time). 

A flow file is just a text file. It contains a list of files that are to be sent to another system, for 
example: 


#c:\opus\outbound\00096581.mol 
#e:\pascal\program.arc _ 


Now for a few details about what may be contained in flow files: 

• File names in a flow file never Include wildcard characters such as *.* or 
???????? arc etc; 

• File names In a flow file should always be fully pathed with disk drive letter and 
full directory path from the root directory (eg c;\opus\outbound\00095681.mo1 
and not just 00095681.mo1); 

If the first character in front of the disk drive letter is a # (hash sign or American 
pound sign -- not an English pound sign!) , Opus will truncate the file (make it 
zero bytes in length) after it has been successfully sent to, or picked up by, the 
destination system; 

• If the first character In front of the disk drive letter is a Opus will delete the file 
after it has been successfully sent to, or picked up by, the destination system; 

• If there is no character In front of the drive letter, the file will not be touched after 
it has been successfully sent to, or picked up by, the destination system. 


Compressed messages 

The oMMM program will compress messages for you using your favourite file compressor. Do 
not forget that the only method of compression that is supported by ALL nodes in FidoNet is the 
original ARC compression employed by ARCA (to create compressed files) and ARCE (to extract 
compressed files). Details on how this is done may be found in the documentation which comes 
with oMMM. 

oMMM creates archives using the same numbering convention as other message archive 
programs. The file name is the difference between the sender's net/node and the receiver's 
net/node. The file extension is ."MO#" where '#' is a number between 0 and 9. In this case, MO 
stands for "Monday". oMMM will also produce "TU", "WE", "TH", "FR", "SA" and "SU" files 
depending on the day of the week when ^e archive is created. 
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6.6 How It All Works 

So far, we have covered bundles and flow files. We have also hit on some of the high points of 
oMMM. More detailed information on oMMM may be found in the documentation which comes 
with oMMM. 


This is the flow of a message ... 

If I have written a message to Doug Boone, the message is in my Matrix message area and I have 
flagged it as KILL/SENT and CRASH (ie, I do not want to keep a copy, so th original in the 
Matrix message area directory will be deleted after it has been bundled and moved by oMMM to 
my outbound mail holding directory). See below for why I used CRASH. 

oMMM is run, and converts the message into a bundle in the outbound holding directory. In my 
route control file for oMMM, I have this: 


ONECM 1:119/5 1;119/All 


This route control file line tells oMMM to build a compressed message bundle using my favourite 
file compressor (whatever is specified in the oMMM.CFG file) to 1:119/5 and mark it CRASH. 
In the bundle will be any messages to Doug (119/5) as well as messages to anybody else in Net 
119. The ONECM verb should only be used when you know the destination system can receive 
continuous mail (the nodelist entry for the destination node is marked CM) and you want to send 
the message now, regardless of the cost. 

Now there is one gotcha that must be mentioned. If you are in a different zone from the zone you 
are sending to, and you wish to send the message DIRECT from your system to the system in the 
other zone, you must mark the message as CRASH in the message editor or the message vvill be 
routed via the appropriate Zonegate system instead of being sent direct. 

If I did not want to incur the expense of an international phone call to send mail to Doug, in my 
oMMM ROUTE.CTL I could use the follo\ving lines instead: 


UNCM 1:119/5 
ONEHOLD 1:119/5 


First oMMM bundles messages it finds in the Matrix message area, then oMMM processes lines 
in the route control file sequentially — one after the other starting with the first line. In this 
example, oMMM would create a compressed mail bundle containing any messages to 1:119/5 and 
mark it as a CRASH bundle (using the .CLO extension for the flow file). The UNCM verb would 
then turn the flow file into a normal .FLO flow file, and the ONEHOLD verb would change that 
.FLO flow file into a .HLO flow file. The mail will now be held for 1:119/5 to collect when Doug 
calls me. 




—from Back To The Future 


Enter Opus, stage right. 


Opus can tell by looking at the outbound holding subdirectory that there is a bundle for Doug. 
Opus infers from the .CLO extension that Doug's system can receive continuous mail. 

It is in the middle of the afternoon. Phone rates between Sydney, Australia and Chico, California 
are the highest that they will be all day. It is a bad time to call. 
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We are not controlling calling times because of our software. The software does not care. Both 
ends can handle Matrix traftic anytime. We are controlling calling times based on the phone 
rates. 

I have a Matrix behaviour window (Z-event) set in Opus that tells the system to make daytime 
calls only to local systems that can receive continuous mail. 


6.7 Controlling Outbound Colls 

You have two primary methods for controlling phone calls made by your Opus system: the Opus 
control file (BBS.CTL) and the event manager program which manages the schedule file of 
events. 

The control file method is in effect if there is no other event to override it. Matrix behaviour 
windows or Z-Events described below are used to override these control file events. 


6.7.1 Opus Control File 

To disable outbound calls, uncomment this line (remove the percent sign % from in front of the 
line) in your Opus control file: 


SEND NOTHING 


To disable long distance outbound calls, uncomment this line in your Opus control file: 


SEND LOCAL 


To enable the sending of mail to nodes which can accept Continuous Mail (these nodes are 
marked with the CM flag in the nodelist), ie, can accept mail 24 hours a day, uncomment this line 
in your Opus control file: 


SEND CM 


With those restrictions. Opus now attempts to send any outbound mail it finds in the outbound 
mail holding area(s). 

If you want to keep humans off-line during a critical mail period, uncomment this line in the 
Opus control file: 


REFUSE HUMAN CALLERS 


There is a way to override these control file settings: Matrix behaviour windows (or Z-E vents). 
Read on... 
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6.7.2 Matrix Behaviour Windows 

A Matrix behaviour window or Z-Event is set up using the Opus Event Manager, OEVENT.EXE 
by Doug Boone. The event starts out looking like any other event... except that it has a Z for the 
tag. 


^^y\(yilUfx4y- ^^€*6 fuyt 

—from a conversation 


When a Matrix behaviour window or Z-Event is in progress, its settings remain in effect until the 
next "Z" event. In other words, the settings do not return to their original value at the "end" of 
this event. 

If you declare a Matrix behaviour window or Z-Event for every day of the week from 09:00 (9am) 
to 12:00 (noon), the behaviour you describe in that behaviour window will be in effect for those 
three hours. Here is the part that needs to be stressed: at noon, the behaviour will remain in effect 
unless there is another behaviour window declared to take effect then. 


That should probably be repeated: 

• You can set up Matrix behaviour in the Opus control file (BBS.CTL). If Opus runs 
into a Matrix behaviour window or Z-Event that is in progress, those control file 
values are gone for the life of the program; 

• To end a Matrix behaviour window or Z-Event, you have to begin another one. In 
this case, the duration of the event means, "go to these values whenever you find 
yourself In this time period". 

• The end of a Matrix behaviour window or Z-Event does not mean return to the old 
values. 

In addition to the start time and end time, there are several other decisions you must make when 
setting up a Matrix behaviour window or Z-Event. 

The following behaviour properties can be set to YES or NO: 
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Item 

What Happens When It Is Set 

To YES 

What Happens When It Is Set 

To NO 

Mail? 

Opus can make outbound calls 
during this behaviour window. 

Opus cannot make outbound 
calls during this behaviour 
window. 

Local only? 

only make calls to systems 
whose cost field (set by your 
nodelist compiler) Is less than or 
equal to the "local cost" that you 
set for this behaviour window. 

it Is okay to make calls that cost 
more than the "local call" cost 
that you set for this behaviour 
window. 

No Local 

Mail? 

do not make calls to systems 
whose cost field Is equal to or 
below the "local cost" that you 
set for this behaviour window. 

it is okay to make calls to 
systems whose cost field Is 
above the "local call" cost that 
you set for this behaviour 
window. 

#CM 

only make outbound calls to 
systems that are marked as CM 
in the nodelist. 

outbound calls are not restricted 
to continuous mail systems. 

Suppress 

exits? 

stop Opus from exiting with 
"after mail" exits (set in the 
BBS.CTL file) after inbound and 
outbound matrix calls. 

allow Opus to exit according to 
the Matrix exits specified In the 
BBS.CTL file. 

Mail only? 

do not let human callers on-line, 
concentrate on mail. 

human callers and the outbound 
calls can coexist. 

File 

requests? 

let other systems make file 
requests on your system. 

do not allow file requests on 
your system. 


The following behaviour properties are set to some numeric value: 


Property 

Meaning 

offset 

errorlevel? 

The offset is added to any errorlevel that Opus exits with during this 
behaviour window. (Optional.) 

Frequency? 

A numerical value used to regulate how often Opus make outbound 
matrix calls during this behaviour window. Range: between 5 and 40 
(5= call every 10 seconds approx, 40 = call every 12 minutes 
approx). (Optional.) 

Local call 
cost? 

A numerical value used to set what Opus is to regard as the "local 
call" cost during this behaviour window. Used by the Local Only and 
No Local options above. (Optional, but you should really use it to 
get the most out of Opus and make outbound call scheduling cost 
effective.) 
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Getting the cost information correct is a 
vital part of controlling outbound traffic! 


During the day (from 06:30 till 20:00 AEST), I have a Matrix behaviour window that has 
LOCAL, #CM, and FILE REQUESTS set to TCS. My local call cost field for this behaviour 
window is 10c. I do not want to make long-distance calls, and I do not want to call systems that 
cannot handle mail on a continuous basis. 



Back to the example, in my oMMM route control file I might have the following lines: 


UNCM 1:119/5 
ONEDIRECT 1:119/5 


So, if I enter a CRASH message to Doug, there it sits, a .DLO file for Doug. Although it says 
Doug's board can accept mail on a continuous basis, the COST field in the nodelist for 1:119/5 is 
$2.50 which is above my local call cost field of 10c. It is an international phone call. 

Opus will not call 1:119/5. 

At 20:00 AEST, the phone rates are lower. I have another behaviour window that allows #CM 
and Non-local calls. In other words, at 20:00 AEST I drop the requirement that all calls be local. 

At that point. Opus will start trying to send the mail to Doug. 

Here is how my Z-Events would go: 

Daytime.CM, Local 

Overnight.CM, Non-Local 

ZMH.Mail only 

For ZMH (Zone Mail Hour), I drop the CM requirement. That lets Opus send to systems that 
cannot handle continuous mail. The point to all of this is that messages stay bundled all the time. 
What changes is the behaviour of Opus. 

That is about it... 

At this point, the standard reaction is "I have some special cases that this won't handle. I have 
several pages of routing and batch files to do all this special stuff." 

Possibly, just possibly, there are some special cases that Opus outbound cannot handle. I cannot 
think of any. Guido says there are none, so do not try thinking any up unless you are fond of grey 
cement shoes and wooden overcoats. 
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6.8 Setting Up Behaviour Windows 

Set up your schedule of Matrix behaviour windows using those set out below as examples of how 
to control when Opus will make outbound calls depending on the cost of the calls. You can fine 
tune them if you want, or add more. The examples below are just meant to serve as a realistic 
guide as to how you should go about setting up Matrix behaviour windows. 


6.8.1 The Zone Mail Hour 

The theory is, if you cannot get a message to another system at any other time, you can send it 
during the relevant zone mail hour (ZMH). One hour is supposed to be set aside for Matrix traffic 
... with no human callers. Being able to accept traffic during ZMH is the sole requirement for 
maintaining your listing in the FidoNet nodelist. File requests are often disabled during the ZMH, 
although this is optional. 


Tag.Z (Matrix Behaviour Window) 

Day.ALL 

Start.(the start of the appropriate ZMH) 

End.(60 minutes later) 

Mail.Yes 

Local only...No 

No Local.No 

CM.No 

Suppress exits.Yes 

Mail only.Yes 

File requests.No (optional) 

Frequency.15 

Local call cost.not applicable 


6.8.2 Overnight Long Distance 

This behaviour window tells Opus that it is okay to make long distance calls because rates are 
low ... but only if the remote systems can receive mail on a continuous basis. 


Tag.Z (Matrix Behaviour Window) 

Day.ALL 

Start.00:00 

End.06:00 

Mail.Yes 

Local only.No 

No Local.No 

CM.Yes 

Suppress exits.No 

Mail only.No 

File requests.Yes (optional) 

Frequency.40 

Local call cost.not applicable 


B4 
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6.8.3 Daytime Local-Only 

During the day, when long distance phone rates are high, you should probably tell Opus not to 
make any long distance calls. In fact, the only calls should be to local systems that can accept 
mail continuously. 


Tag.....Z (Matrix Behaviour Window) 

Day...ALL 

Start.06:00 

End...23:59 

Mail.Yes 

Local only...Yes 

No Local.No 

CM.Yes 

Suppress exits.No 

Mail only.No 

File requests.Yes (optional) 

Frequency.40 

Local call cost.(set an appropriate number of cents, depending 

on what you have in your nodelist control file 
call cost table for local calls) 


You should not skip setting the "local call cost"; it is one of the main ways of controlling the cost 
of outbound phone calls made by Opus and will reward you in the long run by saving you 
unnecessary phone charges. When Opus implemented the "local call cost" field, Guido now sold 
all his shares in the local phone company. Need we say more? 


6.9 Hot to Get Into The Matrix 

The term "Matrix" is used to mean the worldwide amateur email network that is sometimes 
called FidoNef^*^. Although this section describes the operation of FidoNet, there is nothing to 
stop you from creating and maintaining your own private nodelist or joining another network 
using FidoNet technology. 

Getting into FidoNet consists of getting a Matrix address. Those numbers are assigned by NET 
HOSTS. 

You cannot use some communications program to call your net host and log onto his/her system. 
That is not the way this works. Instead, you have to send a message requesting an address direct 
to the Network HOST to prove that your system is capable of supporting netmail. 

Use "-1: -1/-1.0" as your own address when you send the message to the net host. This 
special address tells the net host you are a new system. Never make up your own matrix 
address! Net hosts usually take a dim view of that kind of thing because it can mess up network 
routing, and you need to establish a more positive first impression because you may need his/her 
help at some point. 

When your address is assigned, you will be informed of the address in a return message from the 
network host to ensure that you are also able to receive netmail. 

By the time you have an address, you will have proved that you have a minimally functioning 
system! You will have sent and received mail. 
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6.9.1 Matrix Structure 

The Matrix is a loose collection of fiercely independent systems and system operators. To break 
things down into manageable pieces, the Matrix is divided five ways. You will be dealing with 
the NETWORK and NODE items for the most part: 

Zone 



ZONE 


a very large geographical area, normally a continent 


1 .North America 

2 .Europe 

3 .Australia and New Zealand 

4 .South America 

5 .Africa 

6 .Asia 


Region 



Zone 1's Region 19 covers the states of Texas, Oklahoma, Louisianna, and Arkansas 
REGION ... normally a large geographical area, but smaller than a continent; 
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Network 



NETWORK ... an even smaller geographical area, often based on a local phone company 
free/low cost calling area. 

Node 



A Node is an individual BBS 

NODE ... an individual system; usually a BBS. You are probably a NODE. 


Point 



POINT ... a sub-node, usually an individual with an off-line message reader such as Opus 
Express. Sometimes a BBS can be classified as a point. 

Unless you are sending international email, you do not have to worry about zones. Zone 
Coordinators are responsible for overseeing the coordination of ZONES. 

Major cities are usually designated as NETWORKS in the Matrix. The person who coordinates 
things in a network is called a Network Coordinator (among other not-so-nice things sometimes!). 

The person who oversees the running of the networks in a REGION is called the Regional 
Coordinator. 

A NODE is part of a net or a region. The person who runs a node is you, the Sysop. Your system 
may be either a NODE or a POINT (if it is a point, refer to section 7 of this manual for details of 
setting up as a point. 


^^Notto scale. 
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6.9.2 Matrix Addresses 

A Matrix address looks like this: 

3:711/401.5 

That is a system in zone 3, net 711, node 401, point 5. Most of the time, you will see the 
shorthand version of that: 

711/401 

The address of a Network Coordinator or "host" system looks like this: 

711/0 

That is the host's address for network 711. When you see a 0 as the node number, it is a signal 
that the address is the host. 

The address of a regional coordinator looks just like a network coordinator's address except that 
the first sequence of digits refers to the REGION not the NET. 

There is a special matrix address for systems that have not been assigned an official number: 
- 1 :- 1 /- 1.0 

Never make up your own matrix address! When you send a message to your Network 
Coordinator asking for a real address, use this special address. 


6.9.3 Finding Your Network 

Here is how to find the network in your area: 

• Using a text editor or viewer, look at the raw NODELIST.nnn file. Search for your 
city or town -- or perhaps for other phone numbers having your area code. 

• Find the line that begins with the word HOST. 

Here is an example of the entry: 


I Host,711,SYDNEY NORTH,Springfield NSW,Kevin Mann,61-43-23-2275,9600,PEP,MNP,CM 


This line tells you that folks living in North Sydney are in net number 711. The Network name 
indicates this, but may not always. If it does not imply a geographical area, check the location 
which occurs before the sysop name. 

If you live in a small town, you may not be in a net. Rural areas are covered by regions. If your 
town is not in the nodelist, do a text search for a nearby town or your state, province, or whatever 
you have. 


6.9.4 Asking for an Address 

• Use Opus to generate a Matrix-area message to your network host or regional 
coordinator; 

• Use Opus & oMMM to send your message; 

• Wait patiently for a reply. If you do not hear anything for a few days, you might 
call the host system and leave a local message. 
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6.9.5 Getting Along in the Matrix 

Please remember that network coordinators and regional coordinators do not get paid elephant 
dollars or even peanuts. It is a hobby for them. 

Getting hooked up to the Matrix can be a frustrating experience sometimes. The network 
coordinator knows that... he/she had to go through it, too! 

It is OK to ask for help. 

When things are finally running smoothly, you ought to consider offering to help. You are not a 
consumer ... this is a hobby where everybody pitches in. There's plenty to do, and no net host can 
do it all. The point is that being in the Matrix is not like subscribing to a commercial service. 


6.10 Matrix File Requests 

A file request is when one matrix system asks another matrix system for a file. It is something 
like logging onto the other system and downloading a file, but it is handled during a matrix 
session rather than a human caller session and is usually quicker (read cheaper) because you do 
not have to go through the logon sequence and then search the file areas for the file you want. Of 
course, it is only really of benefit if you know the name of the file you want in advance. File 
requests can help here too. If you request the magic file name FILES, most system will send you a 
compressed file containing an up to date list of files which they have available for request. 


6.10.1 Request Methods 

There are currently two methods for handling matrix file requests: "bark" and WaZOO. "Bark" is 
a telink-transfer method used by some non- WaZOO systems. The WaZOO method uses Zmodem 
and offers more capabilities than the older method. 

Opus will process incoming "bark" style file requests, but never initiates such requests. Opus 
always initiates "WaZOO" style file requests because WaZOO is about an order of magnitude 
more efficient and flexible. Bark is mainly used by older network software. 


6.10.2 Enabling and Disabling Requests 

If you want to allow other systems to make file requests from your system, comment this line in 
the Matrix and Echomail Section of your Opus control file (BBS.CTL) by placing a percent sign 
% in front of it: 


REFUSE FILE REQUESTS 


See the section called "Matrix Behaviour Windows". You can override these control file settings 
with a matrix behaviour window (or Z-Event). 


6.10.3 The OKFILE List 

You will need a file containing a list of files approved for file requests. This is a standard, 
garden-variety text file. It MAY include wildcards. Declare the file like this in the "Matrix and 
Echomail Section" of your Opus control file: 


USES FILEREQ OKFILE c:\opus\okfile.lst 
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This is a "raw" list of fully-pathed file names. Normally, only one file name should be on a line. 
The items must begin in the far left column. The format of a normal OKFILE listing is: 

<path\filename> [!<password>] 


For example, you might place the following in your OKFILE: 


c:\comms\*,* 
c:\net\node*.a?? 
c:\pascal\tp-tutor.zip 
c:\forth\this.one 


You can also include an optional password like this: 


c:\private\*♦* !sesame 


The requesting system must supply the password with the request or Opus will not send the 
requested file if it is in the c:\private\ directory. Instead, Opus will send the ABOUT file as it 
does with all failed requests. The password is always listed as the second item, regardless of the 
type of request (magic, dollar sign, normal). 


6.10*3.1 Magic File Name Requests 

Opus also provides support for so-called "magic" file name requests. A magic file request is 
where you "define" an arbitrary "magic" name and associate it with a particular file or files which 
will be sent if another system requests the magic name. The format of the OKFILE for a magic 
file name is: 

@<inagicnaine> [ !<password>] <path\filenaine> 

For example, you might place the following in your OKFILE: 


@OPUS120 c:\120\oexe_120.zip 
(iOPUS120 c:\120\odoc_120.zip 



QOPUS120 c:\120\oexe_120.zip c:\120\odoc_120.zip 


Notice that each line begins with an "at" sign @ to alert Opus to the fact that this is a magic file 
request. 

You may prefer the first method of putting each associated file on a separate, especially if you 
have 10 or more files being sent in response to a magic file name. It makes it easier if an update 
comes through if you do it on a line-by-line basis. 

You can also optionally password protect magic file names, for example: 


@BETA120 Ikinky c:\120\oexe_120.zip 
0BETA12O Ikinky c:\120\odoc_120.zip 


Notice that the password is preceded by an exclamation point and is the second item listed. The 
password is always the second item listed, regardless of the type of request (magic, dollar sign, 
normal). 
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6.10.3.2 Action Requests 


C6 fxc^ 

fus'^^Cccd iy'l tixc^ 


— Guido 


This is unbelievable powerful. With a little effort, you can implement "intelligent requests." You 
can let the requesting system do such things as ask for information you store in a database. You 
can even install a Directory Assistance service. 

The magic is that the Action Request executes a .COM, .EXE, or .BAT instead of just 
transmitting a file you already have. The specific action has to be listed in your OKFILE. 

Action requests always begin with a dollar sign. 

For example, if the remote system does a WaZOO file request for "LIST" and your OKFILE 
contains this line: 


$LIST C:\STUF\GETDIR.BAT %04x %04x 


The '%04x" items are for Opus to use to stick in additional information. They are C-Language 
format symbols. For more info on this convention, refer to a book on C. 

The data is available in this order :; 

Remote net number (integer) 

Remote node number (integer) 

Future releases might include more than just those two items, so anything you do with the data 
should be protected from additional information appended to this list. 

When the LIST request comes through. Opus will bring up a copy of COMMAND.COM and try 
to execute "C:\Stuf\GetDir.Bat". 

The GetDir file could contain this: 


DIR *.ARC > %1%2.DIR 

ECHO ^%1%2.DIR » C:\0UTB0UND\%1%2.HL0 


See what we did? Opus supplied the net/node of the remote system. The "%04x" items asked that 
the net/node be passed as two 4-character hex numbers. The batch file did a directory of all the 
archives in the current subdirectory, and piped the directory listing to a file made up of the 
net/node number and a tag of ".DIR". Then we told DOS to append or create a .HLO file for the 
remote system in which the .DIR file is listed. In addition, we used a "^" as the first character of 
the listing in the .HLO file as a signal that the .DIR file should be deleted after it is sent. 

In the batch file, %1 will be the requesting system's network number, and %2 will be its node 
number. If the requesting system included anything else, it will get to the batch file as %3 
through %9. The requesting system could so something like ... 


LIST PROGS 


A slight alteration to the batch file could handle this: 


DIR %3 > %1%2.DIR 

ECHO ^%1%2.DIR » C:\0UTB0UND\%1%2.HL0 


Naturally, you can protect these requests by requiring a different password for each one. 
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Another use would be at a zone gateway. You could use this feature as a "Directory Assistance" 
method. Let's say I need to know all the systems in Sydney, Australia. I could put this in a .REQ 
file: 


INFO SYDNEY 


At the gateway, the system could have a customized program that did a case-insensitive pattern 
match on the other zone's node list. The system could have this in its okfile: 


$INFO ZONEFINO.EXE %d %d 


"ZoneInfo.Exe" would be the name of the program that searches the node list. Note that the 
Zoneinfo program would have to open up the .REQ file. The other system has sent additional 
information with the request ("Sydney"), and this additional information is only available in the 
.REQ file itself The information is not pulled out by Opus. Leaving it in the .REQ file gives your 
external program the maximum amount of flexibility. Anyway, the Zoneinfo program opens the 
.REQ file, looks for "INFO", pulls the next token from the same line ("Sydney"), goes through the 
node list doing a pattern match, creates a text file with the requested information, appends a 
.HLO file using the net/node information supplied on its command line by Opus, and quickly 
exits. I said "quickly" because this entire procedure had to be finished before Zmodem times out. 
If your external program will take more time than is available, you can always just drop DTR on 
the modem to end the session and create a .HLO file so the remote system can call back later for 
the information it wanted. 


Another example, in your OKFILE place the follovving line: 


$sendlogs Ipassword c:\opus\getlog-bat %d %d 


GETLOG.BAT contains: 


pkzip c:\opus\logs c:\opus\*.log 

omail kill c:\opus\logs.zip -h%l/%2 -poutbound 


This example runs the batch file, GETLOG.BAT, passing the calling system's net/node number. 
The program OMAIL then runs, creating a file attach to the calling system, and Opus then regains 
control and then sends the file log.zip to the calling system during that call and then deletes the 
file logs.zip (which is why OMAIL was called with the kill command line switch). 

If you need the information, the original .REQ file will be available in your inbound files 
directory to your external batch file or program. 

When Opus sees a dollar sign in the OKFILE, it will immediately call the external program^atch 
file. In other words, if there are any actual file requests in the .REQ file following the dollar-sign 
activator, those file requests will be ignored. 


The power offered by the dollar-sign convention is extraordinary. Its prinnary limitations 
are your ability and creativity. 

The dollar-sign convention offers low-level access to your system. Do not use it unless 
you are sure you know what you are doing. 

When Opus introduced the Action Request into FidoNet, I figured it would be snapped 
up and used for lots of things. It has been copied by such programs as BinkleyTerm 
and other netmail programs, but it still isn't used very much. That's one of my life's 
puzzles. 

_ — Wynn 











Oput^CBCS Sytop OpTotiont Manual 


6.10.4 The ABOUT File 

The ABOUT file is sent on file requests for "ABOUT," or when a file request cannot be satisfied 
because the file requested does not exist or is not listed in your okfile.lst or its name in the 
okfile.lst is misspelt. 

The ABOUT file should tell the requestor something about your system (eg, its main purpose or 
theme) and perhaps your file requesting policy (eg, when file requests can be made, how often, 
how many etc). It could also list any magic file names (see the section on the OKFILE above). 

Opus sends the ABOUT file if a file request fails. So, you might like to explain in the file that it 
may have been received because the file which was requested could not be found or was 
passworded (see the section on okfile.lst above). 

As you include the extension in the control file, the file can be a TXT, DOC, ARC or any other 
kind of file. 


6.10.5 The FILES File 

If the sysop of another system wants to know what files you have available for file requesting, the 
standard Opus method is to request a file called FILES. When Opus receives a request for FILES, 
it will automatically transmit the file that you have declared like this; 


USES FILEREQ FILELIST c:\opus\filelist,arc 


As you include the extension in the control file, the file can be a TXT, DOC, ARC or any other 
kind of file. However, it is kinder to your long-distance and international file requestors to use 
one of the several available file compression programs to compress the file and thereby save them 
a large phone bill. It will also ensure that Guido does not send Nunzio around to measure you for 
those grey concrete shoes he makes. 


6.10.6 Making a File Request 

There are several ways to make a WaZOO file request. 


External Program 

The simplest way is to use a program like OMAIL. It will create all the files Opus needs to make 
a request from another system. 


Do It By Hand 

Opus knows it needs to make a file request when it sees a .REQ file in its outbound holding area. 

It does not make a phone call just because a .REQ file is there. So, in addition to that, you also 
need a .DLO or .CLO file to trigger the phone call. The easiest way to trigger a phone call is to 
use Opus to send an empty message to the other system. When you send a message. Opus and 
oMMM will build all of the .DLO (etc) files that trigger phone calls. 

The file request file is simply a text file which contains a list of the file(s) being requested. 
Wildcards are allowable. Each file name should be on a line by itself You may add a password 
after the file name using an exclamation point / bang / this sign ! immediately followed by the 
password with no intervening space (for example, thisfile.exe ! password) 
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The file name is special and looks like this: 


11112222.REQ 


"1111".a four-digit hex number that is the NET of the system that has the files we are 

requesting. 

"2222".a four-digit hex number that is the NODE of the system that has the files we are 

requesting. 

"REQ".the file tag that tells Opus this file contains file request information. 


• Opus still knows how to respond to the older "Bark" style nnethod for file requests, 
but it does not initiate such a request. 

• The presence of a ".REQ" file does not make Opus make an outgoing call. Only 
".?UT" and ".?LO" files cause a phone call. 


To generate the file request file with Opus: 

• enter a netmail message In your Matrix message area to the node from which you 
are requesting the file; 

• put the name of the sysop (or just Sysop) from whom you are requesting the file 
on the To: line ; 

• put the name of the file you are requesting on the subject line of the message 
(and Ipassword, if applicable): 

• invoke the handling menu (in LORE, press enter on a blank line - in OpEd, press 
'^KH) by choosing H and set the "Request a file" attribute to YES; 

• save the message (see note below); 

• run oMMM which will create the .REQ file for transmission by Opus. 

The message which you entered, assuming you did enter some "body" for it, may or may not also 
be sent to the system from which you were requesting the file. Check your oMMM.CFG file to 
ensure that the NAKED request option is not uncommented. oMMM VI.70 will only create the 
.REQ file if you have NAKED uncommented. The accompanying message (if any) will not be sent 
“ and this means that Opus will not try to make an outbound call, although you may force it to do 
so by POLLING the system to which you now have a valid .REQ file waiting to be sent. 

Another way that some grizzled Opus veterans and a certain LCD have been known to use to 
create requests is to use: 


echo nodediff > c:\outbound\00770000.REQ 
echo > c:\outbound\00770000-DLO_ 


If you do not understand this method, do not worry about it. When you become a grizzled Opus 
veteran, you will! (You do have to know the hexadecimal file name for the destination system 
before you can use this method -- see above for how to work it out.) 


6.10.7 Making an Update Request 

Making an update file request is just as easy as making a normal file request. What is an update 
request? Good question. Oh, you want an answer! It is a request which is conditional on the date 
of the file you are requesting being newer than the copy of the file you already have. 
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To make an update request, refer to the section above on making a normal file request. The 
method is almost identical, except that you set Update Request to YES instead of Request a File 
and when you enter the file name on the subject line, you must give the full path to the copy of 
the file you already have on your system (ie you must type in something like c:\files\thisfile.exe 
rather than just thisfile.exe). 

When Opus calls the other system and transfers the .REQ file, the other system vvill only send you 
another copy of the file if it is newer than the one you already have! 

Advanced Users; note that you can also manually create "update" requests which will result in 
your being sent a file older than the one you have (hint: look at a sample update .REQ file and 
think about the time offset specified therein). 


6.11 The Matrix Menu 

When Opus is at the ready prompt waiting for a call or the next scheduled event, you can get to a 
special Matrix section. 

Press "M" when you see the "Ready" prompt line. The menu includes the following options: 


I) nformation _ 

This generates a chart showing the status of pending outbound traffic and where 
it is going. 


P)oll _ 

Force a call to another systenn whether there is any pending outbound mail or not. 
If a connection is made, Opus will dynamically generate and transmit a dummy 
message bundle if a real one Is not available. 

As many as 10 tries will be made. You can stop the poll by pressing <esc>. If no 
connection Is made after several attempts, Opus will recycle to its on-line 
("Ready") state. 

If a connection is made, you can expect all items for that node to be transmitted 
... except those marked as "hold" or "left". 

When you cancel a poll, you may have to press <esc> a few times. The first will 
cancel the current call; the second one will cancel the poll. 


U)npack _ 

Process/toss any PKT files found in the current default subdirectory. This does 
the same thing as the "-u" command line option. 


S)can _ 

Scans the Echomail message areas looking for new messages that need to be 
gathered up into the outbound area. 


Qlear undialables _ 

Resets the "unavailable" counter for any boards that Opus has found to be 
unreachable, so calls may once again be made to them. 


Q)uit _ 

Quits so that Opus goes back to waiting for the next caller or scheduled event. 


6.12 Forcing an Outbound Call 
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When Opus has outbound traffic but is waiting for a call, you can force it to make a call 
immediately. Simply press "C" when you see the "Ready" prompt line. 

If it has any pending mail (not counting "hold" items). Opus will make a call. In other words, this 
does not cause Opus to make a call it would not have made, it merely speeds up the process. 

Sometimes Opus will just flicker your modem lights instead of actually making a call. This is 
normal behaviour. Just select C)ALL again. 


6.13 Unsuccessful Connections 

Opus maintains a counter. It is incremented when there is an unconsummated connection. 
Whenever there is a carrier but no successful Matrix session, this counter gets bumped. 


If Opus finds a "counter" file showing it tried 
five times unsuccessfully to call a node, 
it will not make any more calls to that node. 


You can manually delete a counter file to enable further calls to the node in question. 

If you have some kind of daily housecleaning routine, you could put this into your batch file: 


DEL C:\OPUS\OUTBOUND\*.?$? 


The path should be your Opus hold area. It deletes all files that have "$" as the middle character 
of the extension. Every time you use this statement, it will re-enable calls to nodes that had 
unsuccessful tries earlier. 

There is also a HOUSECLEANING event which will remove these counter files. 


6.14 Matrix Session Scripts 

Instead of (or in addition to) a phone number, the "phone" field of a record in the node list can 
contain the name of a script file. The script file name and optional phone number must be in the 
following format: 


"FILENAME.EXT"123-456-7890 


The quotation marks are mandatory; they tell Opus that this is a script name. The name within the 
quotes must be the simple file name (no directory path) of a script file in the subdirectory you've 
declared as being the NET_INFO subdirectory. The phone number, if given, must be in the 
format shown. It's used only by the AREACODE and PHONE script commands. 

Script names may be easily inserted into the node list by using the PHONE and/or DIAL 
substitution commands provided by PARSELST: 


phone 124/210 "Hardwire.Scr" 


or 


Dial 

/ 011- 


1-201- 

"PCP.SCR' 

'201- 

1-919- 

"PCP.SCR’ 

'919- 
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6.14.1 Contents of a Script File 

A script file is created with a text editor. Each line must contain a keyword (refer to the Opus 
Technical Reference Manual for a fuller description of the full list of keywords). In many cases, a 
script file will contain other material. 

The keyword must be in the far leflhand column of each line. The system is not sensitive to the 
case of keywords ... uppercase and lowercase are treated the same. 

Some keywords require additional information. You should put a single space after the keyword, 
then start typing the additional information. In other words, if you put a keyword then two spaces 
... the second space will be considered part of the additional information. 


Keywords 

Remember: In actual practice, the following keywords must always begin appear in the far 
leflhand column. 


Keyword 

Xmit 

I 

Dial 


Areocode 


Phone 


Pattern 


Wait 


Session 


Dos 


Carrier 

Init 

Baud 


Description 

Send something to the modem. As in the modem initialization string in the 
control fib, Opus understands the following special characters: 
slight pause 
transmit a <cr> character 

Transmit whatever additional information appears on the same line of the 
script, then wait for a modem response. If the modem reports any kind of 
failure (eg, ’BUSY’), the script will be terminated. NOTE: The dial ’prefix’ 
and ’suffix’ from the control file are not used here. 

Transmit the area code portion of the phone number given after the script 
file name, (e.g., ’xxxxxxxx.xxx’@@@-xxx-xxxx) This is primarily useful for placing 
PC-Pursuit calls. 

Transmit the local phone number portion of the phone number given after 
the script file name (e.g., ’xxxxxxxx.xxx’xxx-@@x§)-@@)^ This is primarily useful 
for placing PC-Pursuit calls. 

Designate a text string to be searched for by the WAIT command. Up to A 
such text strings, numbered 0-3, may be searched for simultaneously. Each 
string may be a single ’word’ (no embedded spaces) up to 20 characters 
long. Upper/lower-case ARE significant; a pattern will only be matched by an 
identical incoming string. 

Wait for any of the text strings previously designated by PATTERN to be 
received from the remote system. The command will continue until either a 
match is found, or there is no input from the remote system for the specified 
number of seconds. The silence timeout defaults to 40 seconds if not given. If 
no match is found the script is terminated. 

In most cases, this will be the lost keyword in your scripts. It means Opus 
should begin a network session with the remote system. The session begins 
with whacking, if necessary. Then it moves through the SYNC procedure into 
the exchange of bundles and files. 

Send a command to DOS. You can process something.or even summon a 
stand-alone netmail session-handler. 

If there is no carrier when Opus reaches this keyword, the script will terminate. 
Go through the normal modem initialization routine. 

Set the computer’s async port to the remote system’s baud rate. 


Example 

xmit AT 

xmit A~T 
xmit 

ATZI~ATH0I 
dial 555-1212 


areacode 


phone 


pattern 0 : 
pattern 1 OPUS 
pattern 2 


wait 
wait2 0 


session 


dos DIR 
dos ARCA test 
* .pkt 
carrier 
init 


baud 
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6.14.2 Script Checklist 

• Script file names are in quotes in the node list phone field; 

• All script files must be In the NETJNFO subdirectory; 

• Each line must have a keyword in the far lefthand column; 

• Most keywords require additional information. This information should be 
separated from the keyword by a single space character; 

• Most script files should end with "session". 


6.14.3 Sample Script 

This script, for PC PURSUIT, was done by Rick Huebner^^: 


init 

baud 

xmit —ATI—ATDT3417733(32 squiggles)- 
carrier 

xmit ~|~D~| 
pattern 0 = 
wait 10 
xmit -Dll 

pattern 0 @ 
wait 10 
xmit ~c dial 
areacode 

xmit /12,username I 
pattern 0 = 
wait 10 

xmit -password I 

pattern 0 CONNECT 
wait 20 

xmit-1-II- ATZI 

pattern 0 OK 
wait 20 
xmit -ATDT 
phone 
xmit I 

pattern 0 OPUS 
pattern 1 SEA 
pattern 2 Fido 
wait 

xmit- 

carrier 

session 


^^Rick Huebner wrote most of the original script manager in Opus. 
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6.15 Matrix-oriented Batch Files 

Any batch file for Opus must be able to respond to the following pre- defined DOS errorlevels: 


Value 

Meaning 

Action 

255 

an internal error generated by Microsoft ’’C’’ (e.g., stack 
overflow) 

recycle 

4 

reserved by Opus 

recycle 

3 

extremely serious error (No FOSSIL, no user file, etc) 

halt 

2 

minor error (i/o error) 

recycle 

1 

'^C (keyboard halt request) 

halt 

0 

??? 

recycle 


Here is a sample, bare bones NERF.BAT batch file to run Opus which assumes that you are using 
Opus internal mail handling capabilities and oMMM to bundle Matrix messages. 

The line numbers are for reference only. They don’t actually go into a batch file. 


1 

: opus 



2 

C : 




3 

cd 

c:\opus 



4 

Opus %1 %2 %3 

%4 %5 

%6 

5 

if 

ERRORLEVEL 

255 goto opus 

6 

if 

ERRORLEVELS 

goto 

opus 

7 

if 

ERRORLEVEL7 

goto 

bundle 

8 

if 

ERRORLEVELS 

goto 

end 

9 

if 

ERRORLEVEL2 

goto 

opus 

10 

if 

ERRORLEVEL1 

goto 

offline 

11 

if 

ERRORLEVELS 

goto 

opus 

12 

:bundle 



13 

c: 

\opus\oMMM 



14 

goto start 



15 

:offline 



16 






NOTES: 

Line 1.Batch file label for ’’goto opus" 

Line 2.Ensure we are logged in to drive c: 

Line 3.Ensure we are in the Opus system directory 

Line 4.Runs Opus with up to six optional command line switches; you would specify 

these by running the batch file like this: 


NERF BBS 


which would cause the batch file to run "OPUS BBS" when it gets to this line. 

Line 5.The check for errorlevel 255 is not really needed here because the following line 

(errorlevel 8) will end up trapping 255. It is put here to stress that 255 is a possible 
errorlevel. 

Line 6.Checking for errorlevel 8 is a safety measure. It will trap any ErrorLevels above 8, 

too. In other words, the batch file is saying "If you get anything else just recycle." 

Line 7.Respond to "After Edit Exit 7". The errorlevel 7 means something in the matrix 

message area has changed. The only thing we need to do is put the new messages 
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into bundles by calling oMMM. This errorlevel happens after somebody enters a 
message in the matrix area. 

Line 8.Errorlevel 3 is a reserved Opus errorlevel. The batch file should halt. 

Line 9.Errorlevel 2 is a reserved Opus errorlevel. The batch file should recycle. 

Line 10.The sysop pressed CTRL-C or ALT-Q on the keyboard to terminate Opus and 

return to the DOS prompt. 

Line 11.Errorlevel 0 is a reserved Opus errorlevel. The batch file should recycle. 

Line 12.The batch file bundle label used in "goto bundle". 

Line 13.Runs the oMMM program to bundle and/or compress any new mail to be sent to 

other systems. 

Line 14.Rerun Opus after bundling any new mail. 

Line 15.The batch file label used in "goto offline". 

Line 16.With DOS, you always have to have a blank line when the last item is a label. 


6.16 Checklist for Going On-line 

• Quadruple check to be absolutely sure that you have a "TZ" environment variable 
set ... and that your event manager Is reacting to it well. When your system is 
waiting for a call, the "Ready" prompt message should show information about 
the next scheduled event or behaviour window. See that the time of the next 
event coincides with your expectations. The "TZ" environment variable can be a 
little tricky. See the "Setting Up Opus V1.70" section of this manual for full details. 

• Make sure you have an outbound holding area subdirectory; 

• Quadruple check to make sure that both ARCE and ARCA are on your path. This 
may seem silly, but some folks had trouble with it. For example, they had 
changed "ARCA.COM" Into "AA.COM" because of a patch message archive 
program; 

• Without both ARCE and ARCE on your DOS path, you can expect problems ... 
tragic and/or humourous depending on your attitude. 


Do this: 

• From the DOS prompt, type ARCE and press Enter. The ARCE program should 
display a help screen. If it does not, do not try to run Opus outbound. ARCE must 
be in the Opus system directory or on your DOS path; 

• From the DOS prompt, type ARCA and press Enter. If ARCA does not respond 
with a help screen, you need to put ARCA in your Opus system directory or on 
your DOS path; 

• Put OPUS.EXE into your Opus system directory; 

• Customize the Opus control file, BBS.CTL, and compile It using NACL; 

• Compile the raw NODELIST to produce your Version 6 or Version 7 nodelist files; 

• Build an oMMM control file and oMMM route file; 
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• Build a new NERF.BAT batch file. 


clvccf c6 


— Eric Sevareid, CBS 
U.S. Television News Commentator 
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7.0 Implementing Point Support 


6ru^ fuyt ct- 

— Confucius 


Opus can function as either a "point" or in its traditional role as a fully-fledged BBS. Starting 
with Opus VI.70, special point support has been added to Opus to make it easy to run Opus as 
either a point or a "BossNode" (usually a fully-fledged Bulletin Board System which provides 
mail facilities points). 

The following sections explain how to set up Opus VI.70 as a BossNode to support a PointNet, 
and as a Point in a PointNet under a BossNode. 

Opus cannot be set up as both a BossNode and as a Point at the same time. You can, however, 
achieve this feat by using two Opus control files and switching from one to the other using 
external events to switch the resulting parameter files at the specified times. 


7.1 What is a Point? 


A point is the perfect solution if you are heavily into messaging and do not have the time or 
inclination to run and maintain a fully- fledged Bulletin Board System. A point is like a small 
BBS with no users other than yourself It does not require the full time, dedicated use of a phone 
line and its phone number is not publicly listed in any list or the nodelist. 

So, what is it really? A point is a computer system which calls a fully-fledged BBS regularly to 
collect any new Echomail or netmail since its last call. The new mail which is collected is then 
read on the point system, "off-line" from the main BBS. The mail collected is usually for one 
person's use only, rather than for general consumption as in 
the case of a fUlly-fledged BBS where users call into the 
system and read the mail on-line. 


A point does not have to be limited to this use only, it is just 
that the majority do use it this way. For example, a point 
could be a fully-fledged BBS which allows users to call in. 
The only limitation (advantage?) with a BBS point is that it is 
not included in the weekly nodelist and does not have to make 
its system available for other BBS calls. 



7.2 How Do Points Work? 

You leave Opus running (or to be run automatically) on your computer system at a pre-arranged 
time each day/night (e.g. in the early morning). At the pre-arranged time (usually when users are 
not allowed on the BBS), your system will phone the BBS to send all your new messages to the 
BBS and pick up all the new messages from the BBS. This should take 2 to 15 minutes at 2400 
baud depending on how many Echomail message conferences you wish, or are allowed, to take. 

Opus then sorts all the new messages out into the various Echomail conference topics and waits 
for you to read them. You can come along at any time and read them, and possibly also reply to 
some of them. You no longer need to try calling the BBS in person to read the messages, you do 
not tie up the telephone lines and there are no time limits. It makes messaging very easy and 
leisurely. 
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7.3 How to Become a Fidonet Point 

A "point" system is allocated a FidoNet address. This means that a person running a point 
(although not listed in the nodelist) can send and receive worldwide netmail, in addition to 
participating in Echomail conferences. A normal BBS FidoNet address consists of a Zone number 
(Australia is in Zone 3), a Network number within that Zone and a node number within that 
Network. For example. Sentry's full FidoNet address is 3:711/409. 

To get a node number in a network (and be listed in the nodelist) you need to be able to send and 
receive mail in the designated Zone Mail Hour and comply with the additional mail times 
prescribed by the particular Network in which you are a node. This means that your system must 
be able to be on line a considerable percentage of the day. 

This is where points and point operators come in. In FidoNet, points are an additional layer in the 
hierarchy under normal nodes. A full point address is made up of the Zone:Net/Node number of 
the BBS (known as the BossNode) which provides the NetMail and Echomail service to the point 
plus a point number: i.e. 3:711/409.1 would be the address of point 1 under node 409 in network 
711 in zone 3. 

The BossNode also usually needs to run special software (eg Opus) to ensure that mail from other 
FidoNet systems is passed on to the point to which it is addressed. It should also be noted that not 
every node Sysop is prepared to provide point services to someone wishing to be a point. There 
are many reasons for this. It does involve extra work for the Sysop of a BossNode, and it is the 
Sysop of the BossNode who is responsible for the behaviour or "netiquette" of the points under 
the node. In addition, nodes which bear a heavy mail processing burden already (for example. 
Network Hosts and Echomail Hubs) will usually not be prepared to provide additional mail 
services to points. The bottom line is, it is a free service provided voluntarily by the Sysop of a 
node. It pays to ask (nicely!) the Sysops of the FidoNet nodes which you frequent whether they 
are able or vvilling to support you as a point off their node. 


7.4 Setting up as a Bossnode 

The first step is to setup a working Opus BBS, which is explained elsewhere in the Opus 
documentation. Once you have the BBS working, it is just a matter of adding a line to your Opus 
control file. 

An official PointNet number may be obtained from your FidoNet Zone Coordinator, but this is not 
compulsory. You are free to choose whatever number your heart desires. To obtain an official 
PointNet number, send a netmail message to the your ZC asking to be allocated a PointNet 
number for your zone. The ZC will then send back to you a unique (to your zone) point net 
number for your use. 

This PointNet number needs to be added to your Opus control file in the section titled "MATRIX 
AND ECHOMAIL SECTION" as follows: 


Address 

3:711/409.0 

% 

BossNode's FidoNet address 

PointNet 

30141 

% 

Your PointNet number 


It is usually a good idea to put the PointNet option directly after your Address option in the Opus 
control file. 

The PointNet option tells Opus to check any incoming mail from the points and strip off the 
SEEN-BY and Origin lines and put the BossNode's Opus system's SEEN-BY and Origin lines in 
the message before passing it on to other systems. 
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To send Echomail to any PointNet node, is simply a matter of including that point’s point address 
(PointNet/Point) in the SCAN line of an Echomail message area definition in the Opus control 
file. For example (note: this area definition has been viciously edited for brevity): 


AREA 0002 

% 

PUBLIC MESSAGES 

DESQVIEW 

ONLY 

ECHOMAIL 

DESQVIEW 

ACCESS PRIV 

Disgrace 

PATH 

C:\MSG\DESQVIEW\ 

TITLE 

Int'I DESQVIEW Conference [Echomail] 

HELP 

C:\OPUS\HLP\ECHOHELP.BBS 

SCAN 

END AREA 

711/0 30141/1 30141/2 30141/3 


Opus's support for points has certain limitations. First, you need to use Opus to process your 
incoming packets so that the correct addressing is placed in the point-generated mail. This leads 
on to the second limitation. When stripping off the SEEN-BY line inserted by the point. Opus 
does not save this information in the message. If the first message in any Echomail message area 
(l.MSG) is subsequently deleted and Opus re-scans messages in that area. Opus will send out 
second copies of the Echomail messages which originated from the point to all the points in your 
PointNet. 


7.5 Setting up as a Point 

To setup Opus as a point. Opus needs setting up almost as if it was going to be run as a fully- 
fledged BBS. This includes having a nodelist available to Opus to enable it to call its BossNode. 
Refer to the documentation for your favourite nodelist compiler program for details of the 
generation of nodelist files. 

Once Opus has been set up as a BBS system, adding point support is simply a matter of adding 
the BossNode option to the "MATRIX AND ECHOMAIL SECTION" of your Opus control file 
along with the Address option as follows: 


Address 

3:30141/1.0 

% Your 

Zone:PointNet/Point 

BossNode 

711/409 

% Your 

BossNode's address 


The address option is in the form Zone:PoinfNet/Point. The address is supplied by your 
BossNode. The BossNode is the address of the BBS which is called to pickup and send mail too. 
It does not include the zone, it is assumed to be the same as the zone in the address field. 

The address used for a point is generally for use between the point system and its boss only. Some 
Sysops consider it to be "annoying" if the address is used to call up their system to plunder its 
files without first getting permission to do so. Other Sysops do not mind at all. Be warned! 

The point can receive netmail by using the full address of Zone:Net/Node.Point. This is 
3:711/409.1 using the above examples. Your outgoing PointNet address will be translated by your 
BossNode to this fiill FidoNet address, and the address on your incoming mail will be translated 
from the full FidoNet address to your PointNet address. 
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8.0 _ Implementing UUCP Support 

by Bev Freed 


... tlxC4X ttclxUxU- fV f'txfUXU^, 

Ulcc^Cdc tCCCCi^C^ c€ 

C4X tlxC tfcUc'!' tlxf^ ^Ctctx' i^ctt 6rC ctc4^X' f^4X€^ CC^VUx^, 

$'fxu^6t 6tc excccduxtyt^ du^yUrt^^MxctcU^^ 

- Plato 


While this section of the manual has no intention of providing full details on UUCP e-mail, some 
explanations as applicable to Opus and FidoNet are in order. 

"UUCP" means "Unix-to-Unix Copy Protocol." It is the means by which many people on FidoNet 
communicate with people on other networks such as Internet and Bitnet. Several gateways 
operate between FidoNet and UUCP to permit such communication, and these gateways are 
indicated in the FidoNet nodelist by the flag "Guucp". 

Opus-CBCS VI.70 is the first version to incorporate UUCP awareness into a FidoNet-compatible 
BBS program. The Matrix section of any Opus VI.70 setup can now be configured to recognise 
UUCP e-mail. 

It must be stated, however, that this UUCP awareness merely means that Opus recognizes UUCP 
e-mail and can offer certain features to make its use much simpler than it has been in the past or 
with the other BBS programs which have netmail capabilities. This awareness does not turn an 
Opus setup into a UUCP gateway. 


8.1 Definitions 

To help you understand the new Opus VI.70 UUCP features, the following is a list of definitions 
which are used throughout this section of the manual: 


Term 

Meaning 

Gateway 

a FidoNet system which has installed the UUCP gateway software 
and has registered with the FidoNet domain recognized by UUCP; 

From: address 

a path showing how a UUCP e-mail message made its way to the 
destination system; 

Address String 

a stand-alone line of characters containing "to:" plus address 
components (Information on who is to receive the UUCP e-mail 
message plus a routing path by which that message is exported 
through the gateway into the proper domain); 

Address Tag 

a name or some alias on the UUCPIist which points to the address 
components Opus uses to generate an Address String; 

Netmail 

point-to-point mail on FidoNet; 

E-Mail 

point-to-point mail on Internet, Bitnet, etc; 

Override 

replace a parameter; 

Cancel 

throw away a parameter 
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8.2 Elementary Fidonet ^ UUCP 

How FidoNet interacts with UUCP depends on your perspective. The gateway has a more 
complicated view of the activity than does a FidoNet system served by a gateway. As the UUCP 
awareness now built into Opus has no impact on UseNet newsgroups (backbone Echomail 
equivalent), the discussion in this manual concentrates on UUCP e-mail, which is the USENET 
equivalent to FidoNet netmail. Here are the basics: 

The host server (often a university) permits a FidoNet system to use UUCP for access to networks 
such as Internet. That FidoNet system (the gateway) has installed the software package which 
facilitates this access. 

As UUCP e-mail is imported from the host server to the gateway, the software on the gateway 
determines if that message is to remain "local" or be exported to another FidoNet system. If the 
message is destined for another FidoNet system, the appropriate zone: net/node address is applied 
to the message, which is then sent out as regular netmail. 

A non-gateway FidoNet system can take advantage of these new UUCP features built into Opus 
VI.70 to enter UUCP e-mail messages, reply to them, and send them via netmail to the proper 
gateway, even if the FidoNet system which delivered a replied-to message was not the same 
gateway. 

When a gateway receives FidoNet netmail bound for UUCP, specially installed software strips the 
message of FidoNet kludge lines reads the Address String, and formats the message for use by 
the host server. On the next connect to the host server, the gateway delivers the UUCP e-mail. 

If you plan to use a gateway, please notify the gateway sysop. Some gateways serve designated 
nets only; others serve none. But a gateway sysop might be willing to accept in-transit UUCP e- 
mail if prior arrangements are made. Some sysops are charged for connect time to their host 
servers; others are not. And remember that UUCP e-mail passing from Internet through the 
gateway to another FidoNet system is traveling as netmail and should be respected as such. 

End of an incredibly basic lesson, folks! 


8.3 Differences Between Fidonet and UUCP 

When you enter a FidoNet netmail message, you respond to Matrix options prompts before 
entering the editor. When you enter a UUCP e- mail message, you respond to many of the same 
prompts, but your responses are different. In addition, some prompts have no meaning. For 
example, you cannot file-attach anything to a UUCP e-mail message, nor can you do file-requests. 

When you enter and save a UUCP e-mail message, that message typically lives out part of its life 
as FidoNet netmail; for the other part, it is UUCP e-mail. (If you happen to enter that message on 
a gateway, its netmail life span is *real* short.) Thus, you must apply both netmail and UUCP e- 
mail characteristics to your message. During its life as netmail, it is sent to a recipient called 
"UUCP." So, how do we insert the real information, such as to whom and where? With the 
Address String. 


8.3.1 The UUCP Address String 

A message destined for UUCP requires an Address String on line 1 of the actual message. It must 
stand alone on this line with no other information, for this string contains data on the person who 
is to receive the message and the path to reach that person. It functions like your to/destination of 


"kludge line" is a way to put things other than the text of a message into the body of the message. 
Kludge lines always begin with a CONTROL-A character and end with a RETURN character. Other 
Information such as the echomail AREA and the message's SEEN-BY list are often stored as kludge 
lines. 
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FidoNet netmail, and must begin with "to:" followed by address components ~ the 
recipient/destination information. It looks something like this: 


to: bevvie@bricks.charm.edu 


or 


to: host!bricks.charm.edulbevvie 


It is this critical string which Opus VI.70 takes into consideration when you reply to or enter 
UUCP e-mail. 


8.4 Opus UUCP Features 

The Opus VI.70 UUCP features work with both the full screen editor and LORE. The following 
is a list of these features: 

• Default UUCP gateway; 

• Default Address String; 

• UUCPIist; 

• Address String verification; 

• Address String handling; 

• Forwarding of UUCP e-mail to Matrix area. 


8.4.1 Scope of the UUCP Features 

Now that you have an overview, you are probably thinking "when are these features appropriate?" 
or "what can I expect?" Some of the explanations here may not be totally clear until you actually 
start playing with the UUCP features. 


8.4.2 Control File Parameters 


To take full advantage of the Opus VI.70 UUCP features, certain lines of the Opus control file 
must be set. These lines are as follows: 

MATRIX AND ECHOMAIL SECTION 


GUUCP 

USES UUCPIist 
MESSAGE EDIT Ask UUCP 
USES VERSION6 


OpEd and LORE EDITOR MENUS 
ED_UUCP 

GUUCP <zone:net/node.point> 


Tells Opus VI.70 the zone:net/node of the system you have assigned as your default UUCP 
gateway. 


Example: GUUCP 1:129/104.0 
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USES UUCPlist <path>\<filename> 


Tells Opus VI.70 the location and file name of your list containing frequently contacted people 
and their corresponding address components. It is just like FIDOUSER.LST, a list of names and 
addresses. The difference is that UUCPlist is UUCP addresses, not FidoNet addresses. If this 
option is specified, you simply enter Netmail messages with the person's name on the address line 
and Opus will look them up in UUCPlist first; if that fails, then Opus tries either FIDOUSER 
(version 6 nodelist users) or SYSOP.NDX (version 7 nodelist users). 

Example: USES UUCPlist c:\opus\uucp.lst 


MESSAGE EDIT Ask UUCP <priv> 


Tells Opus 1.70 the privilege level of anyone who is permitted to cancel or override the default 
Address String. 

Any user below this privilege level will *not* be permitted to send a UUCP e-mail reply to 
anyone other than the individual who sent the original message. 

Example: MESSAGE EDIT Ask UUCP Limited 


ED_UUCP <priv> "<inenu option>” _ 

May be added to the Oped and LORE Menus. It presents the user with a display of the selected 
Address String and a (Y/n)? prompt to accept or cancel that string. 

Example: ED_UUCP Limited "Verify UUCP" 


USES VERSION6 


This line is important for gateways because it tells Opus to use the version 6 nodelist, which is 
recognized by packages such as UFGATE. Gateways should uncomment it. The version 7 nodelist 
can be used by non-gateway systems without any impact on UUCP e-mail. 


8.4*3 The Default UUCP Gateway 

UUCP gateways are flagged in the nodelist by "Guucp." When you want to send a UUCP e-mail 
message. Opus will not waste time scanning the nodelist for the nearest gateway; it uses the 
gateway you have designated via a control file parameter. When you do any of the following, you 
trigger Opus to assign the gateway to that message: 

• Type "UUCP" on the Matrix address line; 

• Apply the default Address String to your message; 

• Apply an address from the UUCPlist to your message. 

Opus does not assign the gateway when you type "UUCP" on the "To:" line of the Matrix options. 
Think of "UUCP" as a recipient whose FidoNet address is your designated gateway. This gateway 
can be overridden by another FidoNet address. 

If you cancel the default Address String, the message destination becomes the originating system 
(which may or may not be the gateway). 

If you override the default Address String with an address from the UUCPlist, the message 
destination becomes the gateway. 

If you cancel the UUCPlist Address String, the message destination becomes the gateway. 
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For details, refer to section 8.3.3 (Control File Parameters) and section 8.6 (UUCP Procedures) of 
this manual. 


8.4.4 The Default Address String 

This feature works only with replies to UUCP e-mail. Opus does the following to generate a 
default Address String: 

• reads the "From:" (or "From") address path of a received UUCP e-mail message; 

• uses that line to generate Address String components; 

• automatically prefaces the components with "to:"; 

• inserts the Address String onto line 1 plus a blank line onto line 2 of the saved 
reply. 

Do not look for this string to appear on your message body. It is applied to the message after it has 
been saved. 

For details, refer to section 8.6 (UUCP Procedures) of this manual. 


8.4.5 TheUUCPiist 

The UUCPlist feature works with both replies and new messages. You create a file containing 
commonly used UUCP addresses. Opus does the following when you type an Address Tag from 
that list onto the Matrix address line: 

• reads the list for the tag's corresponding Address String components; 

• automatically prefaces the components with "to:"; 

• inserts the Address String onto line 1 plus a blank line on line 2 of the saved 
message. 

Do not look for this string to appear on your message body. It is applied to the message after it has 
been saved. 

For details, refer to section 8.3.3 (Control File Parameters) and section 8.6 (UUCP Procedures) of 
this manual. 


8.4.6 Address String Verification 

As you are accustomed to verifying FidoNet addresses, it is a good idea to develop the habit of 
verifying the Address String. Opus does not apply the Address String to the message until the 
message has been saved. Depending on how you have selected the string to use. Opus displays it 
in two places. 

It appears above the Matrix options prior to entry to the editor when all the following conditions 
have been met: 

• the message is a reply, 

• if and only if'Vse UUCP Address" is "Yes". 

It appears on the Editor and Handling menus when either of the following conditions is met: 

• UUCPlist is used; 

• the default Address String is used. 


8.4.7 Address String Handling 
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Whether the Address String is defaulted or extracted from the UUCPlist, Opus permits some 
limited manipulation of that string in the form of a cancellation or an override. 

When Your Message is a Reply 

Prior to entering the editor, you can either cancel or override a displayed Address String via the 
Matrix options. After entering the editor, you can cancel, but not override, via the Editor or the 
Handling menus. At no time, however, can you actually modify the Address String Opus has been 
instructed to apply. 

When Your Message is New 

The only feature which produces an Address String for a new message is the UUCPlist (defaults 
are generated from replies). This string is not displayed prior to entering the editor. Neither can it 
be canceled or overridden from the Matrix options once you have chosen to use it. But you can 
cancel it via the Editor Menu or the Handling Menu after you have entered the editor. At no time, 
however, can you actually modify the Address String Opus has been instructed to apply. 

For details, refer to section 8.6 (UUCP Procedures) and section 8.7 (Editor and Handling Menus) 
of this manual. 


8.4.8 Forwarding UUCP E*mail to the Matrix 

This feature works only with messages having "To: UUCP" in their headers, and does not refer to 
forwarding mail to another system; it refers to forwarding a particular message from one message 
area to the Matrix area on the same system. There may be occasions when a message destined for 
UUCP ends up in a message area which does not handle UUCP e-mail. In the past, when you 
forwarded such a message. Opus added "ffom/to/date" information to the top burying the Address 
String. Opus VI.70, however, does not. When the message contains "To: UUCP" in its header. 
Opus withholds adding the "ffom/to/date" information, thereby preserving the Address String on 
line 1. (Such information is added to all other messages, as usual.) 


8.5 The UUCPlist 

The UUCPlist is like your own personal "UUCP nodelist". Similar in ftmction to Fidouser.Lst, it 
is a simple text file which contains the addresses of individuals you frequently contact via UUCP. 


8.5.1 Creating the UUCPlist 

To create the UUCPlist, simply use a text editor and list one set of address components per 
Address Tag per line as follows: 


<address tag> <address> 


An Address Tag can be any string of alpha characters: single name, first/last names, alias, some 
made-up name — whatever you assign. It cannot be all numeric. 

You have to create and maintain this list with a text editor. Opus does not provide an option by 
which you can adopt an address from some UUCP message. 

When you type a tag onto the Matrix address line. Opus examines the UUCPlist for a matching 
address. If the tag is not found. Opus assumes the tag is a name and begins a search in the 
FIDOUSER.LST or SYSOP.NDX. If the tag is indeed a name, it might appear in both the 
UUCPlist and the FidoNet sysop list. To distinguish between the two, you merely customize the 
UUCPlist tag, ensuring that it is not identical to a name in the FidoNet nodelist. 


Example of a UUCPlist 
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George Brown brown©fvm.info.com 
Boughman pittImuswa.dialix.oz.au!wizard 
Pinhead saddam@bunker.blooey.gov 
Martha Garrity xfgtl@csvax.cal.edu 
Uppity Wench freed@nss.fidonet.org 
Digest digest+@luther.ohio.edu 
Vince Smith digest-request@luther.ohio.edu 
Vince vince@luther.ohio.edu 


Now . .. why "Uppity Wench"? Because "Bev Freed" is also in the FidoNet nodelist. Therefore, if 
you wanted to send a FidoNet netmail message to Bev Freed, you would type "Bev Freed" onto 
the Matrix address line. But if you wanted to send a UUCP e-mail message to Bev Freed, you 
would type "Uppity Wench" onto that line, because when you created the UUCPlist, you assigned 
"Uppity Wench" as the tag to her address components, and thereby differentiated between her 
FidoNet and UUCP e-mail addresses. 

It makes no difference to any UUCP mailer if you do not use the person's proper name on the 
UUCPlist. The mailer does not even know about your list. The components of the Address String 
are what contain the critical information. 

Also, notice that the last three lines on the sample list have something in common: they are all 
related to the same system. This ability to customize the tag is handy when you contact a person 
via different addresses for different reasons. In this example, Vince Smith participates on a 
private e-mail conference called "Digest." He is also the administrator of that conference. Plus, he 
has another address you can use to communicate outside the conference and outside his official 
capacity as conference administrator. You would use "digest" to participate in the private e-mail 
conference. You would use "Vince Smith" to communicate to Vince regarding Digest 
administrative matters. You would use "Vince" when you wanted to send personal mail that 
would not be placed in Vince's official administrative spool on his system. Set the multiple tags 
according to whatever is best for you. 

By the way ... there is only one legitimate entry on that sample list. If you try any of the others, 
you will learn "The Joy Of Bounced Mail". 


8.5.2 Finding a Proper UUCP Address 

There are a few ways to determine someone's proper address: 

• the person tells you; 

• you construct an address using the Fronn: address path; 

• you select the address from the person's signature line at the end of a message 
you have read; 

• you use a "reply-to" line sometimes added to UUCP e-mail. 

Keep in mind that a From: address should, but does not always, represent the proper path. A 
machine routing a message on its way to you may have discovered that another machine was 
down. It may have rerouted the message via a different machine at that moment. The best place to 
obtain a proper address is from the person with whom you wish to communicate. For more 
information or assistance in determining a proper address, contact your gateway sysop. 


8.5.3 Viewing the UUCPlist 

Here is a trick for keeping your UUCPlist handy for viewing even while you are in Opus. Add the 
following line to the Opus control file for your Editor Menu (OpEd or LORE or both): 


_SHOW _ <priv> _ "UUCPlist" = <path>\<f ilename> 


This line lets you see the entire list while you are in the message editor. 
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To enable viewing outside the editor, I simply added that line to my Sysop Menu as well. If you 
maintain the list for users too, you might want to put the viewing feature elsewhere. Just keep in 
mind that the entire list would be available for viewing by all who had access to it. Assign it a 
security level at least equivalent to that for netmail access. Users cannot have separate lists. Opus 
looks for the file name as assigned to UUCPlist in the control file. 

There is one thing to say about viewing the list from the Editor Menu: it scrolls by and disappears 
when the screen is cleared. This does not happen when it is viewed from the Sysop Menu. To 
overcome this disappearing act, I added a below the final entry in the list. Opus does not care 
that the OEC is in there. When it hits this command, it pauses, giving you a "Press Enter To 
Continue." 

Another hint: I have installed my text editor (WordStar) to run off the Sysop Menu. When, while 
browsing through UUCP e-mail or newsgroups, I find an address I want to add to the UUCPlist, I 
scribble that address down, go to the Sysop Menu, call up WS, edit the UUCPlist, save the file, 
then exit WS back to Opus. 

(In fact, I can edit on the fly many files residing on the hard drive while I am still in Opus. Comes 
in pretty handy when I want to see how something looks, create a quick bulletin, etc.) 


8.6 UUCP Procedures 

Now to put this information into practice. The introductory notes and feature overviews should 
give you an idea of what is going on when you browse through these sample procedures. 

Blank Lines 

Many who use UUCP e-mail are accustomed to inserting a few blank lines after posting the 
Address String onto line 1. Although Opus adds a blank line after applying a defaulted or 
UUCPlist Adckess String to a saved message, it is a good idea to add a blank line or two at the 
top of your message in case you decide to cancel the Address String and replace it with one which 
you manually enter. These few extra lines overcome the editor's inability to insert a blank line 
when any text already exists on line 1 of the message body. A blank line or two reserves that 
space. 


8.6.1 Using No UUCP Features 

This procedure should be familiar to any FidoNetter who has ever used UUCP e-mail. 

1 Type "E" to enter a message. 

2 Type the gateway's FidoNet address on the Matrix line. 

3 Type "UUCP" on the To: line. 

4 Type in your subject then enter your editor. 

5 Type the Address String on line 1 in the following format: 

to: <address coinponents> _ 

6 Add one or two blank lines (optional). 

7 Enter then save your message. 

8.6.2 Assigning a Gateway 
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This procedure can be used when you have no default address and no entry for the message 
recipient in the UUCPlist. 

1 Type "E” to enter a message. 

2 Type "UUCP" on the Matrix line. 

Note: The gateway's address automatically appears, and "UUCP" appears on the 
To; line. 

3 Type in your subject then enter your editor. 

4 Type the Address String on line 1 in the following format: 

to: <address components> _ 

5 Add one or two blank lines (optional). 

6 Enter then save your message. 

8.6.3 Using the Default Address String 

When you reply to a UUCP e-mail message, Opus offers you a default Address String and brings 
up a new Matrix option special for replies: "Use UUCP address." When this option is set to 
"YES", the default Address String will be applied to the saved message. 


Verification 

The Address String may be verified as follows: 

• Before entering the editor - above the Matrix options 

• After entering the editor -- via Editor or Handling menus 


1 Type "R" to reply. 

Note: "Use UUCP Address: YES" appears as a Matrix option, and "UUCP" 
appears on the To: line. 

2 Let the "YES" stand and move to the Matrix address line. 

Note: When the cursor hits the "Use UUCP Address" line, the default Address 
String appears on the top of the screen exactly as it will be applied to line 1 of the 
saved message, excluding any name in parentheses. In addition, the FidoNet 
address of the system which sent the message appears. (That system may or 
may not be the designated gateway. The saved message, however, is sent to the 
designated gateway.) 

3 Type In your subject, then enter your editor. 

4 Add one or two blank lines (optional). 

5 Enter then save your message. 

Note: The saved message goes to the gateway. 


8.6.4 Overriding the Default Address String 
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Used for replies, this default can be overridden by an address from the UUCPlist, or it can be 
canceled to be replaced by manual entry of the Address String into line 1 of the message. When 
overridden by an address from the UUCPlist, the default string displayed at the top of the screen 
is replaced by the address from the UUCPlist, as long as "Use UUCP Address" remains set to 
"YES." 

Verification 

The Address String may be verified as follows: 

• Before entering the editor - above the Matrix options o After entering the editor - 
via Editor or Handling nnenus 

1 Type "R" to reply. 

Note: "Use UUCP Address: YES" appears as a Matrix option, and "UUCP" 
appears on the To: line. 

2 Move to the "Use UUCP Address" line. 

Note: When the cursor hits the "Use UUCP Address" line, the default Address 
String appears on the top of the screen exactly as it will be applied to line 1 of the 
saved message, excluding any name in parentheses. In addition, the FidoNet 
address of the system which sent the message appears. (That system may or 
may not be the designated gateway.) 

3 a. To Cancel The Default Address String And Use A Manual Entry Into the 
Message Body, do the following: 


1. Type "N" at "Use UUCP Address." 

Note: When you set this option to "NO", the ability to override with the 
UUCPlist and use the designated gateway are also canceled. 

2. Type in the gateway's FidoNet address. 


3 b.To Override The Default Address String With An Address From The UUCPlist, 
do the following: 


1. Let the "YES" stand and move the cursor to the Matrix address line. 

2. Type the Address Tag as it appears in the UUCPlist, and hit Enter. 

Note: The string which will be applied to the message now appears at 
the top of the screen. Also, the tag Is replaced by the gateway's FidoNet 
address. 


4 Type in your subject, then enter your editor. 

If You Canceled The Default Address String, type the replacement Address String 
on line 1 in the following format: 


to: <address components> _ 

5 Add one or two blank lines (optional). 

6 Enter then save your message. 

Note: If you canceled the default string, the message goes to the originating 
system unless you directed the message to the gateway's FidoNet address. 
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If you overrode the default string, the message goes to the gateway. 

8.6.5 Using the UUCPIist 

An address from the UUCPIist can be used to apply an Address String to a new message or 
override the default Address String of a reply. 

Verification 

The Address String may be verified as follows: 

• Before entering the editor -- above the Matrix options IF the UUCPIist was used to 
override the default Address String 

• After entering the editor -- via Editor or Handling menus 

1 Type "E" or "R” to enter a message or make a reply. 

2 On the Matrix address line, type the Address Tag as it appears in the UUCPIist, 
and hit Enter. 

Note: The tag is replaced by the gateway's FidoNet address. "UUCP" appears In 
the To: line. If the message is a reply, the default Address String display is 
replaced by a display of the address from the UUCPIist. 

3 Type in your subject and enter your editor. 

4 Add one or two blank lines (optional). 

5 Enter then save your message. 

Note: The message goes to the designated gateway. 


8.7 Editor and Handling Menus 

Two new Opus VI.70 features let you verify Address Strings once you are in the editor. They do 
not permit editing. They permit you to cancel any default Address String or UUCPIist address. 
Once you cancel the address, you must enter the Address String manually in line 1 of the message 
body. For this reason, it is always a good idea to insert one or two blank lines at the top of your 
message body to permit such insertion and editing, in case you want to cancel the string after 
already starting your message text. 

When you cancel the default Address String, your message goes to the originating system (which 
may or may not be the gateway). When you cancel an Address String from the UUCPIist, your 
message goes to the designated gateway. 


8.7.1 Editor Menu 

If you have added ED_UUCP to your editor menus. Opus displays the Address String it will apply 
to the message. The display reads: 


Use <Address String> (Y/n)? 


If you type "N", the string is canceled. You might consider making this option available to your 
users, if you permit them to modify the Subject and To lines of their messages once they are in 
the editor. Remember: the Address String is really a "to" string. 
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8.7.2 Handling Menu 

A new option has been added to the Handling Menu: 


G)ated UUCP Address 


When a default Address String or a UUCPlist address is selected for application to line 1 of the 
saved message, this option appears on the Handling Menu, displaying the Address String that will 
be applied, excluding any name in parentheses. 


8.8 Credit Where Credit is Due 

I personally want to thank Doug Boone for tackling this tremendous UUCP adventure. The folks 
out there who run gateways and the many, many people who use UUCP e-mail will benefit greatly 
from his efforts. I also want to thank Trev Roydhouse for asking me to put this section of the 
manual together. And of course, my dearest thanks go out to Wynn Wagner III for being Wynn. 

1:129/104 

ffeed@nss.fidonet.org 


f 
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9.0 


Echomail 


originally by Jon Sabol 


f'tx^rVC' tcdctcdd Uvfo'%4't'Vt\tcC'fX tlxtUX 
U^^X^t^UXCC O-f C6 cc&c^-^ut- 

— Vauvenargues 


An Echomail Conference is a discussion on a particular topic which takes place on a number of 
FidoNet bulletin boards almost simultaneously. A message placed in an Echomail Conference on 
one bulletin board is "broadcast" to all the other boards in ^e network which are participating in 
that conference. There are a number of conferences available, including international ones, which 
cover a wide variety of subjects. Not all conferences will necessarily be available on all FidoNet 
bulletin boards. 

What Echomail does for you is allow you to talk to people on other FidoNet bulletin boards across 
the country and the world without having to know who, or where they are. You can tell an 
Echomail Conference Area from the Area Name. It will say something about the echo, eg. 
mirrors, national conference, etc. All you have to do is enter a message in one of these areas, and 
it is automatically sent out to any and all FidoNet bulletin boards participating in that particular 
Echomail Conference. 


9.1 An Echomail Tutorial 

Before we get down to the nitty gritty of implementing Echomail on your system, it is worthwhile 
spending a few minutes learning about how to use Echomail. What follows is an edited, and 
somewhat updated, version of a tutorial I grabbed from Jon Sabol's system in 1986. Jon was the 
original author of the tutorial. 


9.1.1 Origin Lines 

At the end of each message in an Echomail Area there is a line called an Origin line which shows 
the name and FidoNet address of the board on which the message was entered. That name may or 
may not be a familiar to you. At the end of the origin line there are two or three numbers in 
parenthesis. This is the FidoNet address of the originating bulletin board, eg. Echomail messages 
entered on Sentry have an origin line ending with "(3:711/401)" or "(711/401)". The "3" is the 
Zone number, the "711" is the network number and the "401" is the node number. You can find a 
listing of all the zone/net/node numbers in the entire world in a file which may be called 
'NODELIST.TXT on many FidoNet bulletin boards. 

If you wish to send a private FidoNet mail message (not an Echomail message) to a person who 
has entered a message in a particular conference, you can discover the person's FidoNet address 
by checking the origin line on the particular message which he/she entered. If you do not know 
how to send a FidoNet mail message, ask your friendly Sysop. 


9.1.2 Private Messages 

All the messages in each Echomail Conference area are sent out to all the other participating 
bulletin boards, even if they are labelled private. Most FidoNet bulletin board software now only 
allows public messages in Echomail Conference areas. Beware! If you want to send a private 
message to someone, you should not use an Echomail area. You should, instead, use the FidoNet 
mail area (also known as the Matrix area on Opus bulletin boards). 
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9,1,3 Person-to-Person Messages 

Generally, person-to-person messages should not be entered in an Echomail Conference. If you 
have a message for Bill Bloggs, and no one else is likely to be interested in it, then use FidoNet 
mail and not Echomail otherwise the sysop of every bulletin board participating in that Echomail 
Conference will pay to receive it. A message between two users in Sydney, received on a BBS in 
Perth, is not likely to win you any friends. It can be worse! If the particular Echomail Conference 
is an International one, your message could end up on numerous FidoNet bulletin boards across 
North and South America and Europe. 


9.1.4 Thank-You Messages 

If you do receive a flood of replies to a question which you entered in an Echomail Conference, it 
is only natural to want to thank each individual who replied. Don't do it! Those 15 short one line 
messages saying "Thanks for your reply <fill in the name>" will be echoed everywhere and are 
only of interest to the recipients. You have two choices: (1) send a FidoNet mail message, or (2) 
send a single "global" thank-you message in the Echomail Conference (e.g. "Thanks to all those 
who helped with my modem problem. It is now fixed."). 


9.1.5 Off-topic Messages 

Every Echomail conference has a subject; do not stray too far off it. Most Echomail Conferences 
have a moderator who will step in and shout if the topic strays too much. Unless you have been 
involved in a particular conference and have a good grasp of its scope, be cautious about entering 
messages on new topics. 


9.1.6 Replies Should Stand Alone 

When you reply to a message in an Echomail conference, mention enough of the previous 
message so that readers can tell what you are replying to. It is maddening to see someone 
discussing the merits of a previous message when you cannot figure out what the previous 
message is about. On the other hand, it is equally maddening to see someone quote an entire 
message in reply only to add a short comment like "I agree" or "Me too". 


9.1.7 Delayed Replies 

Also, remember the delay inherent in an Echomail conference. If you post a question, don't expect 
a response tomorrow. If you reply to a question, realise that many others may be replying at the 
same time, and that a flood of messages in reply may pour in over the next several days. This will 
be particularly so in the case of large National or International Echomail Conferences. 


9.1.8 Commercial Advertisements 

Commercial advertisements are not allowed in many of the Echomail Conference areas. Why 
should the individual sysops who bear the cost of moving the messages around the country, and 
the world in the case of international conferences, pay for your advertising? If you do enter a 
commercial advertisement, you will probably be warned not to do so again and your message will 
be deleted. If you persist in entering commercial advertisements in an Echomail area you can 
expect to have your access to the relevant bulletin board cut off by the Sysop. If you are a Sysop, 
your link to that particular conference may be cut. 


9.1.9 Cost of Echomail 

F 
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Echomail is not free. Echomail messages are sent via local, long distance and international 
telephone calls. Unless sponsored, the Sysops involved (particularly the Sysops of "Echomail 
hubs" and "host systems") bear the cost of this, and so users are not charged for Echomail 
messages [at least in Australia]. 


9.1.10 Conclusion 

Now, all you have to do to use Echomail is read the messages in the Echomail Conference Areas 
and enter or reply to them. Echomail takes care of the rest. Please participate in Echomail with 
us. We provide this as a free service, and really enjoy seeing it put to use. Enjoy! 


9.1.11 Encounters of on Abbreviated Kind 

In Echomail messages you are bound to stumble over some of the abbreviations listed below. This 
list is far from exhaustive. It is a sample of the abbreviations you will sometimes see: 


>( 

frown 

:-) 

grin 

;-) 

wink 

BTW 

By The Way 

FWIW 

For What It's Worth 

IMHO 

In My Humble Opinion 

IMHO 

In My Honest/Humble Opinion 

IMNSHO 

In My Not So Humble Opinion 

L8R 

Later! 

LCD 

An Opus Lower Code Dweller 

MYOB 

Mind Your Own Business 

OTOH 

On The Other Hand 

ROFL 

Rolling On Floor Laughing 

TNSTAAFL 

There's No Such Thing As A Free Lunch 

TTFN 

Ta'ta, for now. 

ZMH 

Zone Mail Hour 
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9.2 How Echomail Started 

Once upon a time, way back in 1985, Chuck Lawson (Dallas) and Harv Neghila (San Francisco) 
noticed they were spending lots of time in chat with each other ... running up their long distance 
phone bills. "There's got to be a better way," they concluded. 

"We ought to do something like netmail chat." 

That subject was brought up at the next notorious Dallas sysops' pizza party. All the sysops had 
opinions and suggestions, as is expected. 

Somebody noticed that Jeff Rush had quietly taken out paper and pencil. He seemed to be taking 
notes. 

The idea was forgotten -- that is, by everyone except Jeff. A month or so after the discussion, he 
popped up and said, "Here 'tis!" 

It was a couple of programs which make up the heart of the Echomail system ... and which had no 
similarity to any of the designs laid out so carefully on our pepperoni conference table. 

He wrote a two programs: SCANMAIL, to move outbound messages from an Echomail area into 
the netmail message area, and TOSSMAIL to move inbound messages from the netmail message 
area into the Echomail area. 

We decided to try it out by starting two Echomail message areas. One for sysops, cleverly called 
SYSOP... one for users called TECH. Messages bounced around (most of the time) between 
systems run by Chuck Lawson, Jon Sabol, and Jeff Rush. 

The next day two other message areas were added: CHATTER and POLITICS. Two other 
systems were added: Wynn Wagner in Dallas and Harv Neghila in San Francisco. 

Chuck-to-Harv: the first backbone. They were spending their long distance money again. Now, it 
wasn't just for their chatting. It was for chatting from Jon and Wynn and Jeff, too... and all they 
users on all five systems. So it went. 

In short order, other sysops started getting curious and interested. The SYSOP area spread out 
quickly. 

One of the earliest battles was to keep Dallas sysops from talking about the most recent picnic or 
pizza party. It took quite some time for the locals to realize their little local Echomail area was 
not little or local any more. <wiping brow> [Ed: Guido's brow?] 

Another early problem was net hosts and region coordinators. Nobody realized that the volume of 
Echomail would grow so quickly. At first, Echomail went out like any other e-mail... through net 
hosts. Those hosts quickly made it known that they were not amused by the sudden increase in 
their long distance bills. That seems like a reasonable attitude, and everybody agreed that 
Echomail would never be "host- routed" again. 

"This is going to bring the network to its knees," was the cry from some quarters. 

So far, though, it seems to be working. 

The amazing thing is, Echomail is working in spite of its lack of a firm organizational structure. 
The backbone is an informal coalition, and they certainly would not presume to tell you what you 
can or cannot do with Echomail... as long as you stay polite. Maybe it should be stated like this: 
Echomail is working because of its lack of a firm organizational structure. 
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A quotation from Wynn Wagner III (March 1991): 


Jeff Rush is sometimes called the person who invented Echomail. That is absolutely not 
correct. Echomail was thought up by the sysops of Dallas. It happened at one of our 
pizza parties. Two sysops (Chuck/Dallas & Harv/San Francisco) were the first to draw up 
a design document. Jeff was the first to show up with working code. I don't want to 
lessen Jeffs contribution to Echomail, but I need to make sure other toes aren't stepped 
on. 


... and a quotation from Jeff Rush (March 1991): 


In my opinion, the idea of echos was to cause all the little pockets of interesting ideas 
that only a few could find/dial-into to multiply into large lakes of discussion others could 
listen to. Specific boards should blur into the whole net, and the item of focus becomes 
the conference Itself with its readership, and not the BBS with its user base. This 
provides better dissemination of new ideas geographically. 

Sort of like reaching critical mass and achieving fusion of the mind. 

It means users choose their entry point into the conference based on system availability 
and registration requirements, and prevents a sysop from gaining a hold o ideas. 

I very much object to the (seemingly) natural tendency of people to form cliques or 
clubs, and to withhold membership as a form of social control. I see it on the big 
networks and in technical support areas. People let 'friends' into special conferences and 
brag about how they might be able to get you In if you are up to their standards. 

With echos. If the sysop is a jerk but the readership base is interesting, you go find 
another system that carries the echo. 

Freedom of choice, we carry all flavors ... coke or pepsi or... 


You will find several national and international conferences on dozens of technical and non¬ 
technical subjects ... from Opus to C to Pascal to science fiction and genealogy. 

To be involved vvith an Echomail conference, you first have to get a Matrix address. Although 
Echomail is not affiliated with FidoNet, it would be impossible to handle Echomail without 
FidoNet's Matrix structure. If you do not have an address, you need to take care of that first. 
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9.3 Routing and Coordination 

Most Echomail conferences have a coordinator. Someone who is supposed to help with hookups 
and to keep the discussion on track. Most good coordinators are quiet. That is because most 
Echomail conferences rely on the goodwill and cooperation of participating sysops. 

Some Echomail conferences are on whaf s called "the backbone". A collection of mostly mail-only 
systems that do very little other than process and send Echomail. 

Like almost everything else that touches Opus, Echomail is a grassroots sort of deal. It is not a 
commercial service that has subscriptions, and you are not a consumer. If you get involved, you 
can be expected to share in the expense and in the responsibility. But that is what makes it a 
hobby! 


Important 

In some Zones, eg Zone I (North America), Echomail is never ’*host-routed”. It is sent directly 
from one system to another. In Zone 3 (Australia), however, Echomail is nearly always "host- 
routed" — but then everything is upside down for us. 

Do not attempt to send an Echomail conference through your Net Host, Hub, Regional 
Coordinator or ZoneGate Operator without obtaining their approval to do so in advance or your 
career in the Matrix may well be very short-lived. 


9.4 Getting Started with Echomail 

1 Find an Echonnail conference you want to carry on your system. This is all fairly 
informal. Here are some suggestions: 

• Log onto another local system that carries lots of Echomail. Leave a note 
to the sysop saying "Hey, can I tie into such-n-such on your board?" or 
"Where can I tie Into this area?" 

• Check your net's newsletter or local sysop echo. Many local nets publish 
an up-to-date list of Echomail conferences. 

• If you hear of some conference that is not available in your area, you can 
put yourself In charge of calling to bring it to your area. That is the way 
Echomail conferences spread out! 

• If there simply is no conference that suits you, find another sysop who 
shares your Interest and start your own Echomail conference. That Is 
precisely how conferences begin. 

• Do not assume you will get a helpful hand from your net host or regional 
coordinator. Remember that Echomail has nothing to do with FidoNet, and 
some hosts/coordinators do not want anything to do with it. 
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2 Set up an Opus Echomail message area definition in the Message Areas Section 
of your control file (BBS.CTL). A sample message area definition is given below: 


AREA 


0030 


woe 


NAME 

% MENU 

SECTION O 

PUBLIC MESSAGES ONLY 
% ALIAS 

ROUTE 
ECHOMAIL 
ACCESS PRIV 
EDIT PRIV 
ACCESS LOCK 
EDIT LOCK 
% PEEK PRIV 

% PEEK LOCK 

% Upload PRIV 

% Upload LOCK 

PATH 
TITLE 
MAXLINES 


MEADOW % Area No/Name 

% Another Area No/Name 


<Number> 


% Opus Section 
% No private messages 
% No aliases 

% Private replies by netmail 
% Echomail tag 
% For visiting 
% Sysops 
% but only Opus 
% Sysops 
<privilege> 

<locks> 

<privilege> 

<locks> 

C:\MSG\MEADOW\ % Message directory 

Int'1 Meadow Conference [Echomail] 


MEADOW 

Extra 

Extra 

M 

M 


60 


% Three screens! 


% 

BARRICADE 

<filename> 



ADDRESS 

3:711/401.0 

% 

Who am I? 

ORIGIN 

WOCket Test Site, Sydney, Oz 

Q, 

"O 

Where 

% 

I? 

% 

DOMAIN 

<string> 


% am 

PICTURE 

<filename> 



HELP 


C:\OPUS\HLP\ECHOHELP.BBS 

% 

Help 1 

% 

CHARSET 

<ISO set> 



% 

PASSTHROUGH 



SCAN 

621/201 

681/854 711/907 % Where 

to 

next? 


END AREA 
% 


Make sure you tell the system that the area is for ECHOMAIL and that it is to be 
"PUBLIC MESSAGES ONLY". (It Is normally considered bad manners to send 
private messages in an Echomail conference.) Refer to section 2 of the Opus 
Technical Reference Manual for a detailed explanation of the options in the 
message area definition above. 

3 The Opus control file has some other Echomail-related options which are listed 
below. Some of the options are designed to make Echomail processing as 
automatic as possible, or to allow the use of an external Echomail processor. A 
full explanation of these options may be found in section 2 of the the Opus 
Technical Reference Manual. 
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DOS CLOSE STANDARD FILES 
USES ECHOTOSS 
LEAVE ECHOTOSS 
Path BadEcho <path\> 


LOG 

SCAN 

ECHO 

ECHO 

ECHO 


Echomail 

Echomail 

Guard 


MAXECHO 


EconoScan 

NOALIAS 

<Kbytes> 


AFTER Mail Exit <Nuinber> 

AFTER Inbound Exit <Nuinber> 

AFTER Inbound Toss Echomail 
AFTER Toss Exit <Number> 

AFTER Arcmail Exit <Number> 

AFTER Arcmail Extract Packets 

MESSAGE SHOW Ctl_A to Hidden 
MESSAGE SHOW Seenby to Hidden 


4 Compile your BBS.CTL file with NACL to produce the BBS.PRM file which Opus 
needs to run. 

5 In your NERF.BAT batch file that runs Opus, set things up to run oMMM from 
time to time, to bundle messages for transmission. Refer to the sample 
NERF.BAT file in Appendix A. 


9.5 The Echomail Scan Process 


The Echomail scan process is triggered by one of three things: 

• Echomail messages received through the Matrix. If scanning is enabled, the 
messages are scanned after all bundles are uncompressed and tossed. Only the 
areas that have new messages are scanned. 

• A caller entering an Echomail message, provided you have the SCAN ECHOMAIL 
option in the control file uncommented. If scanning is enabled, the messages are 
scanned after the caller's logs off. Only the Echomail areas that have new 
messages in them are scanned. 

• Selecting S)can from the M)atrix menu either while Opus is sitting at the "Ready" 
prompt waiting for a call or the next scheduled event or as an option off the Sysop 
Menu (in the latter case Opus will wait until the Sysop logs off before scanning). 
This will scan all Echomail message areas which you have defined in your control 


file. 


Bundles are created as .OUT files in the subdirectory designated as your outbound holding area. If 
you need other processing to take place after the scan, you can use the AFTER TOSS EXIT 
feature. The exit is supposed to happen after messages are scanned, whether the cause of the scan 
was the fact that messages came in from the Matrix or were entered by a caller. The most likely 
use for this EXIT will be to call oMMM to get the .OUT files into compressed mail archives. 
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10.0 


Using an External Mailer 


fUAxt &C'0'*xC' 

— Tobias Smollet 


You can configure Opus VI.70 to load an external mailer after it loads itself. The mailer will 
handle any matrix mail sessions. When it detects a human caller, the mailer should exit with a 
DOS errorlevel of baud/100. Opus will automagically trap this errorlevel, set its own baud rate 
and run the BBS for the caller. 

If the mailer exits with an errorlevel other than a valid baud rate/100, one of two things will 
happen: 


• If the errorlevel = 255, Opus will assume the mailer quit (perhaps because you 
want a human-only window). Opus will no longer load the external mailer but will 
run itself as usual. 

• In any other case, Opus will exit with the same errorlevel, plus the usual Z- 
behaviour window offset (if any). 

Since Opus remains in memory when the external mailer is loaded, there will be no delay 
between the moment Binkley, or any other compatible mailer, exits and the BBS starts. 

Note: With this setup. Opus runs the mailer (eg BinkleyTerm) instead of the other way around. 


10.1 Opus Control File Settings 

To use the external mailer option you must define the command to run the external mailer in the 
Opus control file. You must also tell Opus whether to use its internal mailer or the external 
mailer as the default mailer. You therefore have to set the MAILER COMMAND and MAILER 
LOAD options in the Matrix and Echomail Section of the Opus control file. For example: 


MAILER COMMAND BT.EXE share 

% 

Run 

Binkley 

MAILER Load 1 

% 

0 = 

Internal 

% 1 = Load external 




% 2 = Call external 





You should also uncomment the following line: 

REFUSE Inbound Traffic _ 

which will prevent the following anomalous situation from occurring: 

• the mailer answers the phone, decides that the caller is a human and passes 
control to Opus; 

• Opus decides the caller is a mailer and tries to do a mail session; 

• the caller, a human, disconnects and Opus goes back to the Ready prompt 
instead of taking the "after caller exit" caller and reloading the external mailer. 

1 
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10.2 External Mailer Settings 

A couple of notes about using External mailers like BinkleyTerm are in order. First of all, you 
will notice that with Binkley you must use the share command line switch to force Binkley to 
leave the FOSSIL driver "hot". Binkley must not deinitialize the FOSSIL driver on exit. This will 
probably be necessary with other mailers which use the FOSSIL driver. 

If you use Binkley you should also put "BBS EXIT" in your Binkley configuration file instead of 
using the batch or spawn method to start the BBS. This will tell Binkley to exit with the baud 
rate/100. You should use a similar configuration with other mailers. 


10.3 Opus Mailer Events 

The mailer event is an event which tells Opus whether to use its own internal mailer or load an 
external mailer. The mailer event setting overrides the Opus control file setting. 

You can set Opus to use its internal mailer in the Opus control file and have a mailer event that 
will run your external mailer at a predetermined time. Or, you can set Opus to use an external 
mailer in the Opus control file and have a mailer event that will run the Opus internal mailer at a 
predetermined time. 

Whenever you have scheduled a mailer event. Opus will use either its own internal mailer or the 
external mailer specified in the Opus control file depending on which mailer the mailer event 
specifies. 

For example, if you have told Opus to use its internal mailer in the Opus control file, have set an 
external mailer command in the control file, and have a mailer event scheduled at 1:00am to run 
the external mailer. Opus will exit at 1.00am to the external mailer using the command line 
specified in the Opus control file. The external mailer will then run until you set another mailer 
event telling Opus to use its internal mailer again and exit from the external mailer to Opus (ie 
the external mailer must be set to exit to Opus a minute or two after the Opus mailer event is to 
come into effect). 

Obviously if both the Opus control file and the mailer event agree on which mailer to run, nothing 
will happen. When they disagree, whatever mailer the mailer event specifies will override the 
Opus control file setting. 


10.4 Opus Mailer Command line Switch 

You can also set an external event that would start Opus with another mailer by using the "-M" 
Opus command line switch. For example, you could have a FrontDoor command line set in the 
Opus control file for one mailer event and then start up Binkley with a command line such as: 


Opus BBS -M"bt.exe unattended share" 


The -M command line switch will override any setting in the Opus control file. 

Note that the mailer's command line is in quotes. This is necessary and vvill cause problems if it 
is not done. You should not put the external mailer's command line in quotes when it is specified 
in the Opus control file. 

Also note that there must not be a space between the -M and the first quote: Opus BBS -M 
"bt.exe unattended share" will not work properly. 


The -M command line switch will override both the Opus control file setting and the mailer event 
setting and run the specified external mailer instead. 
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10.5 External Mailer Example 

In this example the following assumptions are being made: 

Ithe default mailer is set to the Opus internal mailer; 

2. the Opus control file has the mailer command set to use BinkleyTerm; 

3. an Opus Mailer event is set to start at 1:00am and use the external mailer 
specified in the Opus control file (Binkley); 

4. an external event is set to exit Binkley with errorlevel 255 at 2:00am; 

5. an Opus mailer event is set to start at 2;00am and use the Opus internal mailer; 

6. Opus has an external event set to exit with errorlevel 100 at 3:00am; 

7. the Opus batch file Is set, using the -m Opus command line switch, to run Opus 
with FrontDoor as the external mailer if Opus exits with an errorlevel of 100. 

In the above set up, if Opus is started at midnight it will use its own internal mailer. At 1:00am, 
Opus will load Binkley. At 2:00am Binkley would exit to Opus and Opus would use its internal 
mailer. At 3:00am, Opus would exit with an errorlevel of 100 which would be trapped in the 
batch file to run Opus with the -M command line svvitch to load FrontDoor. 


10.6 Scheduling External Events 

If you have several external events which run various utilities, you will find that having those 
same events scheduled to be run by the external mailer and by Opus will, naturally enough, cause 
the events to be run twice. 

For example, if Binkley (as the external mailer) is active when the event is due, it will exit with 
the specified errorlevel, the errorlevel will be trapped, and the programs specified in the batch 
file will be run. Then Opus will restart, and before it loads Binkley, it will notice that it has not 
run the event; so it will run it (with the same errorlevel), and the event will be run twice. 

Now why would you do that? The answer: you want whichever of the external mailer or Opus that 
is active when the event should be run to run the event. If the events are not duplicated in Opus, 
and a caller logs on just before an external event, the caller would be able to overrun the time 
when the event should start. 

Two ways of resolving this problems are described in the following sections. Refer to the section 
of this manual describing the Opus Event System for further information about events or 
behaviour windows. 


10.6.1 Option One 

Set up forced "dummy" external events in Opus so that Opus will know how much time is left 
until the next external event. The dummy events should all exit with the same errorlevel that is 
trapped by the batch file and simply reruns the batch file. 

Opus will regain control, load the external mailer, the external mailer will exit with the 
appropriate errorlevel (make sure it is not a valid baud rate; refer to section 10.0 above). Opus 
will pass the errorlevel on to the batch file, which will in turn take the appropriate action. 

Under this setup, callers to the BBS will not be able to overrun the time when the events should 
occur. 

I 
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10.6.2 Option Two 

Set up the external events in Opus as usual; set up forced dummy external events to cause the 
external mailer to exit to Opus shortly after (1) an Opus mailer event specifying that Opus should 
use its internal mailer and (2) the Opus external event; set up another Opus mailer event 
specifying that the external mailer should be loaded after the external event has occurred. 

The external mailer will relinquish control to Opus which will then use its own internal mailer (ie 
not reload the external mailer) and will execute the external event. Opus will then execute the 
mailer event and reload the external mailer. 

Under this setup, callers to the BBS will not be able to overrun the time when the events should 
occur. 
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10.0 


Opus Security 



Pudd'nhead Wilson 
(Mark Twain) 


Opus-CBCS has endured as one of the most secure on-line systems available.Opus VI.70 
maintains that heritage and adds many more features that give the sysop much improved security 
management flexibility. 

Do not feel obligated to use all the features just because they are there. It is recommended that 
you set up your system with moderate security features using the privilege levels at first, then take 
advantage of additional features as your needs demand it. The security systems for on-line users 
are both flexible and potentially complex. If you have an idea on how you vvish to setup your 
system, but think that Opus security features will not handle it, study them some more. It is very 
likely that you will be able to achieve the desired end result by a careful selection and application 
of the various options. 


11.1 On-line Users 


Most sysops are concerned with flexibility in designing Opus CBCS security layout for on-line 
users. Opus has four primary adjuncts to achieve flexibility — sections, privilege levels, locks, 
and passwords. These are described in the following section. 


11.1 •! Sections 


Each on-line user of a system can be allocated a "section" by the sysop at logon or can define 
their own section from flie section menu. The ability to choose sections from the section menu 
can, of course, be restricted by privilege level and/or by locks. 

A section restricts a user's access to your Opus system. It is used to allocate message and file 
areas, so that a user will only be able to access those areas which are included in their allocated 
or chosen section. You can look at sections as being something like TBBS SIGs, except that the 
use of sections in Opus is optional. 

Sections have a couple of extensions to be considered, MSG_SCAN, F_NEW, MSGJSIAREA, 
F_LOCATE and the NextArea/PriorAreas menu commands will no longer be concerned with the 
high message/high file area limits. They read the section area table in the user record directly. 

You define the section(s) to which a message or file area belongs in the message or file area 
definition in the Opus control file using the SECTION option. The implementation of sections. 


^^When Opus just a baby, some hackers discovered my phone number. They thought it was great fun 
to call and break into my system-in-development or to lock up my computer. Instead of trying to chase 
them off, I taunted them and dared them to try it again. This went on for several months. Every time 
they'd come up with some new outrage to spoil the system. I'd learn a new trick from the hackers. The 
other reason Opus security is so good is because of David Finster. He was a test site. David is the 
most under-handed and sneaky and mean tester I've ever seen. When a piece of software gets to the 
point that David says it's tough to break, you have a solid system. Most of your protection is behind- 
the-scenes, and Opus never logs it or makes any mention of it. But it's there, and it's thanks to some 
hackers in Dallas. That said, I should also remind you of this; no software is absolutely secure. 
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and user defined sections, is treated in detail in the section of this manual dealing with ... 
sections! 


11.1.3 Privilege Levels 

Each on-line user of a system is assigned a privilege level. This level is used by Opus to set many 
operating parameters. Iliese parameters include: 

• Access to various Opus functions; 

• Total on-line time per day; 

• Total on-line time per session; 

• Lowest connect speed that can be used to access Opus; 

• Lowest connect speed that can be used to download files; 

• Total file kilobytes that may be downloaded per day. 

Opus has twelve privilege levels: 

• Hidden 

• Sysop 

• Asstsysop 

• Clerk 

• Extra 

• Favored 

• Privil 

• Worthy 

• Normal 

• Limited 

• Disgrace 

• Twit 

In order for a user to have access to a privilege protected function in Opus, he must have a 
privilege level equal to or greater than the function's privilege level. For example, most Opus 
systems v^ll have a menu option in the MAIN menu to access the FILES section. If the FILES 
command has a privilege level of FAVORED, then the user must have a privilege level of 
FAVORED or higher to access, or even see, this command. 

HIDDEN is a special privilege level. You might think of it as being so high that no one can get to 
it. It is used for hiding a function from all users. This would be useful for hiding a menu option to 
a game door that you are constructing. If you set a user's privilege stored in the Opus user file to 
HIDDEN, it will cause Opus to hang up on them after they enter their password at logon. 

In your Opus configuration file, you set times, speeds, and file download quantities and file 
upload/download ratios associated with each privilege level. 


11.1.3 Locks and Keys 

The "locks and keys" concept gives the sysop very flexible and powerful security management 
over a variety of functions in Opus. Locks are associated with the Unction and each user has a set 
of keys. There are 32 locks defined. They are denoted by letters and numbers as 
[ABCDEFGHIJKLMNOPQRSTUVWXYZ 012 3 4 5] for locks 1-32 respectively. If a user attempts to 
access a function within Opus that has locks associated with it. Opus \vill compare the locks that 
are set against the user's keys to see if there is a match. For example, suppose a user has keys A, 
D, and 3 enabled and wishes to access the DOWNLOAD command, which has the D lock 
enabled. 


User Keys: [A. .D. 3..] 

Download Locks; _ [ ♦ . .D.] 
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The user's key set will unlock the DOWNLOAD command, provided his privilege level is equal 
to or higher than the privilege assigned to the DOWNLOAD command. 

A simple application of locks might be to use them for certain meanings. Here is an example 
scheme: 

D.Download access 

U.Upload access 

E.Enter Message access 

F.File area access 

V .Visiting sysop (use to limit access to certain functions and areas reserved for calling 

sysops) 

Y .YOU - set aside certain functions that only You can access 

Use your imagination. Locks and keys give you great control over your system. 


11.1.4 Passwords and Barricades 


Opus uses additional password protection to provide yet another level of security. Of course, 
every user normally must have a password to log onto your system. A second password feature is 
the area barricade file. Any Message/File area in Opus may have a set of passwords associated 
with it. These are defined in a password file associated with that area. The file is a plain text file 
in the following format: 


Password Security_Level ;coiranent 

FirstName LastName Security_Level ;comment 


The ;comment field is optional. Opus stops reading the file after the password and security items. 
An example password file for an Echomail message could look like this: 


SESAME ASSTSYSOP ; 

SHILOH PRIVIL 

GREYSTOKE NORMAL 
PERFECT NORMAL 
JANE TRUSTED PRIVIL ; 


area moderator 

those who can enter Echomail messages 
those who cannot enter messages 
those who cannot enter messages 
Jane will not be asked for a password 


A unique aspect of the barricade file is that it temporarily adjusts the user's privilege level to that 
associated with the password entered to gain access to the area. Be sure that the privilege level 
associated with each password in the file is sufficient to pass the access privilege level for the 
area and its associated menu commands. 

Whenever users leave a barricaded message or file area, they lose the higher or lower privilege 
which was conferred on them by the password file. As an added security measure, if a user logs 
off or otherwise disconnects while in a barricaded area. Opus always resets the last message or 
file area accessed, as appropriate, to area number 1 and resets their privilege level to what it was 
before they entered the barricaded area. 

Unlike Opus VI.lx, in VI.70 both message and file areas may be separately barricaded by 
defining a password file associated with the relevant area definition in the Opus Control File. 
Refer to the USES BARRICADE and BARRICADE options in section 2 of the Opus Technical 
Reference Manual. 

For further details on implementing barricaded areas, refer to the section 3 of this manual on 
Setting Up Opus. 


11.1.5 The User List 

The user list may be considered to be a sensitive list on some systems. The sysop may limit the 
availability of the menu option to list users by using the locks and privileges described above. 
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There is a second method to view the list that is not readily apparent. Opus has the convenience 
of letting you search the user list when posting a private message. This helps you to find the 
correct spelling of the person's name that you wish to send a message to. If the user list is to be 
secured, the ability to view it when posting a private message needs to be defeated. This is done 
in the control file by enabling the option: 


EDIT DISABLE USERLIST 


The user also has security options related to the user list. He can select what portions of 
information he allows to be displayed in the user list by going to the Change menu and turning on 
or off the options. These are: 


List User's Name 
List User's City 
List Last Time Called 


Once again, the sysop has ultimate control. If the sysop does not want users to have access to 
modifying the user list attributes, the sysop can disable the Change Menu option for selecting list 
attributes by using privilege levels, locks, or simple omission of the item from the menu. 

The Opus command line switch -NL is the same as the Opus Control File option EDIT DISABLE 
USERLIST and will override the control file setting. 


11.1.6 Outside Security 

The REBOOT option in the Opus Control file is a security feature which will protect your system 
from being left in an unknown state should you or another caller hangup or otherwise disconnect 
while outside of Opus. 

For example, if the sysop calls in and drops to DOS but loses carrier due to line noise, the next 
caller to ^e system would find themselves at the DOS prompt. Callers who find themselves at the 
DOS prompt have, on occasion, been known to do a lot of damage with a few strategic commands 
like FORMAT E:, FORMAT D:, and finally a FORMAT C:. Of course, you could recover from 
this disaster because you have everything currently backed up ... you do have everything backed 
up? 

Specifying REBOOT in the Opus Control File turns on the watchdog function in the fossil driver 
when a user selects a function that will cause Opus to exit with an errorlevel. By turning on this 
function, the fossil will cause a system reboot if the caller is lost while the caller is outside Opus. 


11.2 Application of On-line Security 

This section is devoted to illustrating the application of on-line security measures. To the new 
Opus sysop, the security options may seem like a spaghetti bowl and very confusing. The diagram 
in figure 11.2-1 should help you understand the hierarchy of things. Remember there are sections, 
privileges, locks, and passwords. These apply in numerous places in Opus. The reason so many 
places exist is to provide maximum flexibility in configuration. 

Here are some basic guidelines that you may want to follow: 

Use sections to restrict users' access to the various areas of your system. For example, you could 
use sections on a product support system so that only users with product A could access areas 
with section A set (ie those areas dealing with product A). 

Use menu command privileges and locks to globally control access to things that will apply to the 
majority of your areas. 

Use area specific privileges and locks to control those things in an area that are the exception to 
pj the majority of your areas. 
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If none of the above satisfy your needs, then your fmal option is to build a separate menu file for 
use in a specific area or sets of areas. This method carries with it more maintenance. A separate 
menu file gives you ultimate flexibility in configuring your system, but try to use the other Opus 
facilities first. 


Figure 11.2-1 Hierarchy of Opus Security Options 
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! Sc 

! Sc 

1 

1 


Locks 

i Locks 

1 Locks 

1 

1 



11.2.1 Menus 


Opus menus are wonderfully flexible for security. You are only limited by the types of commands 
that are allowed in each major section of Opus — MAIN, FILES, h^SSAGES, SECTION, 
CHANGE, HISTORY, SYSOP and CUSTOMl-6. You may add and delete commands, change 
privileges and locks, and change the wording of the menus and even the menu prompts. The rules 
for building menus are explained in detail in the Opus Technical Reference Manual in section 3 
(Opus Menu System). The use of privileges and locks on commands is readily apparent, but the 
use of multiple menu files may not quite be so obvious. 
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Separate menu files are useful when you have one or more areas that need to be treated as 
"exceptions" to how your menus look for most of your areas. Suppose most of your message areas 
are set to use the menus shown in Figure 11.2.1-1. These menus are set in your default menu file, 
ENGLISH.MNU. You also have two genealogy-related conferences on your system and would 
like to make available a database program through the menus, when the user is accessing either of 
these conferences. Just define another menu called ENGLISH.OOl as shown in figure 11.2.1-2 for 
your genealogy conferences and specify that these conferences vvill use menu number 1. 


Figure 11.2.1-1 

Sample menus defined by ENGLISH.MNU 


ECHO area 12 . 

.. Communications 


Area change 

Enter Message 

Reply 

Next 

Prior msg 

Current msg 

Goodbye 

Select 

Kill message 

?Help 


ECHO area 25 . 

.. Vietnam Veterans 


Area change 

Enter Message 

Reply 

Next 

Prior msg 

Current msg 

Goodbye 

Select: 

Kill message 

?Help 


Sample menus defined by ENGLISH.OOl with External Program Command for Genealogy 
database search 


ECHO area 16 . 

.. Genealogy 


Area change 

Enter Message 

Reply 

Next 

Prior msg 

Current msg 

Goodbye 

Kill message 

DATABASE Search 

?Help 



Select: 




ECHO area 17 
Area change 
Next 
Goodbye 
?Help 
Select: 


Jewish Genealogy 
Enter Message 
Prior msg 
Kill message 


Reply 

Current msg 
DATABASE Search 


11.2.2 Areas 


It is quite common to have a need for security variations from area to area. The first level of 
security checked per area is the barricade password option, if you have it enabled. In Opus VI.70 
the barricade password for an area is separately definable for each message and file section. In 
Opus l.Ix, the same barricade password applied to the message and file area which had the same 
area number. All area associated security options are now independent of each other with respect 
to message and file areas. 

In message areas, you have separately definable privilege levels and locks for each of these: 

• Area access; 

• Message creation (Enter or Reply or Upload or Upload Reply); 

• Every external program. 

In file areas, you have separately definable privilege levels and locks for each of these: 

• Area access; 
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• Download connmand; 

• Download & Hangup comnnand; 

• Upload command; 

• Every external program. 


11.2.3 Opus Embedded Commands 

Opus embedded commands provide the sysop with the ultimate flexibility in customizing system 
security. There are embedded commands to control presentation of text file segments to a user 
according to privilege level and key settings. These are explained in detail in the embedded codes 
section on customizing Opus. With embedded commands, you could do things like: 

• Present a note of explanation, then hangup on a user that is relegated to privilege 
level of TWIT. 

• Ask a set of questions, then automatically invoke a callback validation program. 

• Ask a set of questions and change a user's privilege level with an external 
program depending on their answers. 

• Ask a set of questions and add or remove a user's keys using the OECs to add 
and remove keys. 

• Present access to external program such as on-line games, but do so on the 
basis of privilege of key settings. 

• Lock out a mail waiting program to new users based on privilege level. Since they 
are new and will not have any mail waiting anyway, it prevents a useless "Check 
for mail". 

• Present an AREAINFO file (see section 5 of the Opus Technical Reference 
Manual -- Opus Support Files) in your "members" area where you require new 
users to post short biographies about themselves. After the users are validated 
and their privilege is raised, the AREAINFO will not display to them based on 
their elevated privilege level. In this way, they can go read the biographies of 
other users without the annoyance of having to read the file that gives new user 
instructions. 


11.3.1 Matrix and Echomail Security 

If a sysop runs matrix and Echomail with Opus, there may be a need to use security measures to 
protect against unauthorized access, unauthorized routing of mail through your system, prevent 
hostile file upload via the matrix, prevent unauthorized pickup of mail, and even prevent the 
insertion of bogus Echomail into die system. All of these things can and have happened in 
different networks. Opus provides a number security measures to help protect you from these 
attacks on your system integrity. 


11.3.1 Session Level Passwords 

In order to prevent a node from "impersonating" another node and picking up their mail, matrix 
session level passwords may be implemented. Opus supports password matrix sessions with other 
mailers. The password can be up to eight characters long. Opus treats upper and lower case 
characters in the password as the same character, i.e., "Password" is the same as "PASSWORD". 

You insert the passwords for the various nodes into your nodelist using your favourite nodelist 
compiler. Refer to the documentation for your nodelist compiler for details on implementing this 
option. 
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11.3.2 File Requests 

When you set up your system to accept file requests and update file requests, you can password 
certain files in your file request list to prevent unauthorized access to those files. This might be 
useful if you are part of a software test team and you want to make new versions of the software 
available in a secure way to your team. See the section on file requests in the matrix mail section 
of this manual on how to setup passwords. 


11.3.3 Echomail 

Unfortunately, there have been instances of Echomail abuse wherein an errant sysop sent 
inflammatory or bogus messages into a conference by sending them to a node in the matrix that 
carried the conference. Opus has protection for this with a feature called ECHO GUARD. You 
simply enable this feature in the Opus control file. With this feature enabled, any message 
received for a conference which does not come from a passworded connection, will be tossed into 
the matrix area and marked as an orphan. If you have the PATH BADECHO enabled, the 
messages will be tossed into the bad messages directory. 


11.3.4 Intransit Mail 

Intransit mail is mail that is sent to your system but is addressed to another system. There are 
legitimate and intentional reasons to do this. However, it is hardly welcome, if someone sends 
mail to your system that is destined for a long distance telephone call. If your system processes 
the mail and sends it along, guess who gets to pay the phone bill? You, yourself, you. 

Opus has protection against intransit mail that you do not want. There are four options in the 
Opus control file to help protect you. They are: 


REFUSE All InTransit 
REFUSE Unpassworded InTransit 
REFUSE Nonlocal InTransit 
REFUSE Attribute InTransit 


The function of each of these is explained in detail in the Opus Control File Parameters section of 
the Opus Technical Reference Manual. 
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11.4 Opus Name Filter 

Opus has its own inbuilt "bad name", "dirty word" or "trashcan" name filter for filtering out the 
undesirable names which some callers to your system invariably try to use for their logon name. 
The filter is also handy for stopping that rogue modem which wants to log on to your system using 
your phone number for its name! What? You do not get those calls? You will. 


11.4.1 Control File Settings 

To use the inbuilt name filter you need to uncomment the USES NAMEFILTER option in your 
Opus control file (BBS.CTL). For example, 

USES NAMEFILTER c;\opus\misc\username>txt _ 


The precise format for the file "usemame.txt" is described below. 

There is also another control file option, USES BADNAME, which you may optionally use to 
deliver a custom message to the caller whose name has been rejected by the filter, just before 
Opus hangs up. For example: 


USES BADNAME c:\opus\misc\badname 


Note: When you define the file name for the badname message, you do not use a file extension. 
However, the file you define must be an OEC file with a BBS extension (ie, the file in the 
example would be badname.bbs). 

Do not forget to recompile your BBS.CTL file with NACL after making these changes! 


11.4.2 Filter Name File Format 


The filter name file contains a sequence of lines that are interpreted in one of two ways, 
depending on the first character: 


Symbol 

Meaning 

Example 

? 

(question nnark) 

the material that follows on this line is not to appear 
in any form In a caller's name 

?shit 

! 

(exclamation mark, 
or bang symbol) 

the material that follows on this line Is not to appear 
AS IS in a caller's name. This is a case sensitive 
filter. 

!Ass 

# 

(hash sign, 
or pound sign)^^ 

converted to a SPACE character. Lets you keep off 
people who try to call themselves "AH" without 
keeping out people named "Allison". 

7AII# 


Remember that Opus converts all names to an uppercase character followed by lowercase 
characters. In the first example, the character sequence "shit" would be disallowed in any form in 
a caller’s name. In the second example, "Ass" would be thrown out ONLY if it appears as the first 
Three characters of a caller's first or last name. The reason for the second (case sensitive) version 
is this: the characters "ass" appear in several legitimate names. 


11.4.3 Behaviour of the Filter 

Opus will go through the file defined by the USES NAMEFILTER option on a line-by-line basis 
after an unregistered caller types his/her name. 


^^Pound is the U.S. weight, not the English currency. 
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If Opus finds a problem, it will either: 

• pretend that you run a PRIVATE systenn that requires pre- registration and hang 
up on the caller after sending the nnessage "This is a Private system."; or 

• If you have defined a badname message file, Opus will show that file to the caller 
before hanging up. 

Problems include a match with any item in the USERNAME.TXT file ... or some DOS I/O error 
in reading the file. 


11.4.4 Errors in the Filter Name File 

The name filter is really an idiot when it comes to error recovery. It assumes that if you are using 
the filter, you know how to use it. 

Here is an example, if a line in the name file begins with some character other than "?" or "!" 
then the entire line is ignored. There is no error message. 

In a nutshell, if you decide to use the filter you need to be sure you are using it correctly because 
the system's primary job is that of a filter ... not a tutorial on its usage. 


11.4.5 Specific Examples of Use 

Set out below are a few specific examples of how to use the inbuilt name filter. These are all 
taken from a working filter file that has not been modified in months, so you should not encounter 
any unexpected problems. 

Note: each item should appear by itself on its own line, starting in the far left column. The setting 
out in the following sections is to save space. 


11.4.5.1 One-Letter Names 

To prevent callers from using one letter names, you need to have the following in your name filter 
text file: 



11.4.5.2 Rogue Modem Names 

To prevent those rogue modems from logging on to your system, you need to have the follovmig in 
your name filter text file : 


?atd 

? + 

?4 

?8 

?atz 

?1 

?5 

?9 

?atdp 

?2 

?6 

?0 

?atdt 

?3 

11 
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11.4.5.3 Shy Caller Names 

Some callers are very shy when it comes to revealing their real name(s) to Opus. Here are a few 
of the more common shy personalities for your name filter file: 


?test 

?qwer 

?asdf 

?visitor 


11.4.5.4 Dirty Word Names 

You will have to supply your own, but here are a few pointers. The following entry will prevent 
anyone using "Xxxx" as a first name, middle name or last name: !Xxxx# 


11.4.5.5 Wannabe Hacker Names 

Ever since 1986 when Fido VI Iw was in vogue, there have been the wannabe hackers who try to 
log on to a system as "All", "Anyone" and "Everyone" and then merrily proceed to go through the 
message areas deleting messages. Of course, with today's volume of Echomail this may no longer 
be the major disaster it once was! To spoil their fim, add the following to your name filter file: 
lAll# I Anyone# I Everyone# 

What about ye olde "Hacker" who calls? You may have to handle this case carefully. A quick 
check of the Sydney metropolitan telephone directory reveals about a dozen people listed with 
that surname, so it is not necessarily a good idea to lock out "Hacker" with: !Hacker# unless you 
are sure either that (1) you will not get any calls from legitimate Hackers, or (2) you do not want 
any calls from anyone with that name. 


139 






Opui-CBCS Syiop Operatlont Manual 




12.0 

Opus Folklore 


fcrcrt Cd Uc' tUcnlcif 4e 

C6 f^^yi ctxc (stt fi'tc 

— Baltasar Gracian 


Opus has attracted its fair share of... "Guido, put that bat down NOW!" ... 


12.1 TheElusiveNERF.BAT 

Ever wondered why the batch file commonly used to run an Opus-CBCS is named NERF.BAT ? 
Well, here is how it all began ... 


From: Wynn Wagner III 
Subj: RE: Nerf.bat 

DEEP BACKGROUND. 

It started here at work on my first project in C. I’m an old 
assembly language jockey, and I was having some trouble with C. 

I used to take the white K-and-R book on C (that’s kind of the C 
Bible), put it on the floor, and jump up and down on it. 

My manager at the time bought me a nerf hammer and told me to use 
it on the book so I didn’t cause quite so much damage. She also 
said this: I was going to get you a nerf bat, but I figured the 
hammer was more business-like. 

I still have the hammer in my office. I still use it sometimes. 
The K-and-R book was worn out years ago. 


NERF FOR OPUS. 

I did some of the docs for Opus 0.0. [Editor’s note: it was the 
VI.00 docs] On a lark, I stuck in nerf bat in the Required 
Equipment list. 

I mean, it’s for hobbyists. There wasn’t any requirement to be 
businesslike, so the bat made more sense than the hammer. 

The 0.0 docs were full of junk like that: quotes and leg-pulling 
and on and on. There’s a difference between being serious and 
being solemn. The 0.0 docs were serious, but they weren’t very 
solemn. 


MISSING THE WHOLE POINT. 

Somewhere along the way, somebody did some docs for Opus called 
NERF FREE. As far as I can tell, about the only thing these 
’unauthorized’ docs did was remove the humor. 

Nowadays, the Opus ByLaws And Covert Action Committee requires 
humor for Opus documentation, so that kind of nonsense won't 
happen again. _ 
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... and the list of required hardware in the Opus VI.00 documentation read: 


Required Hardware 

Standard equipment for Opus consists of: 

AT-class computer with Award BIOS 
72-Meg hard drive 
One each: 

TeleBit Trailblazer modem (9600 bps) 

U.S.Robotics HST modem (9600 bps) . 

Amdek 722 EGA monitor 
PC DOS 3.3 
Mirror sunglasses 
Nerf bat 

That roughly describes Wynn's computer setup. It is the only one 
that carries any sort of assurances. It is: 

Opus will sometimes run on Wynn's computer. 

No other assurances are made. 

All other equipment is officially classified as Non-Standard. 


... and then there was THAT message in the MEADOW: 


From: Jim Beeler 
To: All 

Subj: Nerf.bat 

I have a friend at work who I am helping set up an OPUS BBS for 
his company located in Tokyo, Japan. Being Oriental, he possesses 
infinite patience and, unlike his American counterparts in the 
U.S., realises the importance of following instructions to the 
Letter. 

He began installing OPUS utilising the OKITs. Soon he discovered 
the missing items: Mirror Shades and a NERF Bat. Realising that 
these must be necessary items, he pulled out his sunglasses. The 
nerf bat, however, was another problem. Not realising exactly 
what a Nerf Bat was, but none-the-less realising that if it was 
in the documentation it must be necessary, he searched through 
the .ARC files for further references to the elusive Nerf Bat. 
Finally, he figured it out! 

He called me over to his computer to see the installation of OPUS 
that he had done ... from the C:\ prompt he evoked NERF.BAT and 
up came OPUS. 

So, for those of you that have trouble locating a Nerf Bat, take 
a lesson from a wise Oriental, just rename your RUNBBS.BAT to 
NERF.BAT. 

Jim. 


... and now you know what, hithertofor, only some of us really grizzled Opus veterans were privy 
to. 


12.2 Identifying the Chico Connection 

You can tell someone from Chico by two words, "fir" ("I'm going fir some beer.") and "ahmund" 
("We knock the 'L' out of them." You have to see the way almonds are harvested to get it.) 

— From a conversation 
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12.3 oPOLO: Opus Policy^ Version Zero 

(pronounced "oh-pahl'-oh") 

This is the official policy statement of WOC: 

QRe ^^VbrCdwidc Opus Consortium 


12.3.1 Dress Code 

WOC sysops must wear mirror shades. 


12.3.2 Attitude 

There is a difference between "serious" and "solemn". 

Any WOC sysop caught being solemn will be referred to the Enforcement Squad of the Opus 
ByLaws and Covert Action Committee for a solemnectomy. 

Any WOC sysop caught being sirius will be sent to Bob Klahn for technical support. 


12.3.3 Backbiting, Snide Remarks, and On and On ■ 

Any WOC sysop who backbites, or makes a snide remark to another WOC sysop, or who on-and- 

on's will be forced to memorize the entire set of GBS/BBS embedded commands. B 

Note that the "snide remark" clause only refers to other WOC sysops. If s okay to snipe at non- 

WOC sysops. j 

12.3.4 Matrix 

If you run netmail, you gotta run Zone Mail Hour. ■ 


12.3.5 Transients 

If you accept "In Transit" messages, you can't delete or change the content unless it would be 
illegal for you to transmit the messages. 

If you do delete or change messages, your title is "editor" instead of "host." Because WOC doesn't 
have a title anything like "editor", deleting or changing a message is the same thing as resigning 
as host. 

The change clause does not apply to software which adds "Via" or "SeenBy" or other automated 
festooning for reasonable technical purposes. 
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12.3.6 Rules in a Nutshell 

Rule #1: Don't take yourself so seriously. 

Rule #2: Run Zone Mail Hour. 

Rule #3: Don't delete or change "in transit" messages. 
Rule #4; Send code. 


12.3.7 Enforcement 

Except where noted, this is a codification of Natural Law. It is not necessary to account for 
enforcement of such things as the National Mail Hour in the same way as it isn't necessary to 
enforce the Laws of Gravity. 

It is like there is no need to make a law that says "All bachelors must remain unmarried." That 
would be silly. When a bachelor gets married, he's simply not a bachelor any more. When a 
system doesn't run Zone Mail Hour, it isn't running net-mail. It's very simple and straight¬ 
forward. 

Enforcement of the Unnatural Laws, such as wearing mirror shades, is absolute. It is now a 
standard that any WOC software incorporate enforcement procedures. For example, when 
entering chatmode, WOC software will produce a brilliant flash on the monitor that could result 
in eye damage to anybody not wearing mirror shades. 


12.3.8 Disclaimer 

Membership in WOC doesn't preclude membership in any other association. WOC is neither for 
or against anything or anybody, and never takes a stand on any issue (except mirror shades). 

12.3.9 Merit Badges 

The following merit badges are available to WOC members: 

• Continuous Mail... 

WOC AROUND THE CLOCK logon certificate 

• 386-based mail system... 

WOC DON'T RUN gbs file 

• WOC system carrying more than 50 Echomail areas... 

WOC ON THE WILD SIDE ribbon 

• New WOC sysop... 

OUT OF THE SKILLET INTO THE WOC badge 

Penalties for improperly displaying a WOC badge or honor gbs file are too severe even to 
mention. 


\ 
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13.0 More Information on Opus 


de^%clv j(4m ca cxcilte4\^' 

— Cicero (106-43 b.c.) 
_ Roman philosopher 


There are two ways to find out more about the way Opus works and to get questions answered. If 
you are having problems with Opus, contact one of the InfoNodes. Please do not contact them if 
you have not carefully read the whole of the Opus Technical Reference Manual and the Opus 
Operations Manual. 


System name Phone number Location _ FidoNet 

OPUSinfo'West' 1-404-296-9681 Atlanta, Ga 1:1/113 

OPUSinfo'Under' +61-2-872-3571 Sydney NSW Australia 3:3/113 

OPUSinfo 'Europe' +46-46-138039 Lund, Sweden 2:200/420 

OPUSinfo 'East' +866-6-237-0657 Tainan, Taiwan 6:721/100 

System name How to contact_Notes 


OPUSinfo 'Snail' P.O. Box 16410; San Francisco Ca 94116 Send SASE 

OPUSarchive 1-713-980-9671 Houston Texas 1:106/2000 Specs etc 

The above nodes are for questions involving specific problems. They can give you answers to 
some of the most commonly asked questions. Other help nodes are; 


System name 

Sentry 

Sentry's Shadow 
Milliways BBS 
NS BBS 


Phone number FidoNet 

+61-2-428-4687 3:711/401 
+61-2-418-6682 3:711/501 
1-703-491-5445 1:265/100 
1-412-366-5208 1:129/104 


Notes _ 

Technical Reference 
Operations Manual 
oMMM operation 
Meadow echo area 


For general discussions about the usage of Opus, you should seriously consider subscribing to the 
Opus sysop Echomail area, called MEADOW. Any of the distribution nodes can refer you to a tie- 
in point for this area. If all else fails, contact Bev Freed at 1:129/104 for information pertaining to 
MEADOW Echomail connections. 

MEADOW carries the same copyright as Opus. You are required to act in a friendly and lawful 
manner if you participate. We are trying desperately to keep a casual and constructive atmosphere 
in the Opus area. If that is not your intent, please do not subscribe to the conference. If you wish 
to discuss technical aspects of the programs, you are wholeheartedly welcome to join!! I 

Here are the MEADOW "rules" posted by the moderator (aka the Uppity 
Wench... don't ask!): 
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From: Bev Freed 
To: All 

Subj: Meadow Rules 

Guess what? It's that time of the month again: MEADOW 
ADMINISTRIVIA! 

TOPIC: Meadow is for the discussion of Opus problems, the future 
of Opus, Opus utilities, suggestions, ideas, and support among 
Opus sysops. It is involved in the technical operation of Opus 
and responsible to the Opus Bylaws and Covert Action Committee. 

PARTICIPANTS: Opus sysops ONLY! Definitely UNAVAILABLE to users. 
While sysops of other systems are welcome to READ Meadow, they 
can't expect answers to QBBS, TBBS, Fido, or 
whateveryourerunningthisweek. That would be off-topic. 

RULES: In addition to general rules for any conference. Meadow 
rules are simple, standard, and may be bent a little, but not 
trashed. The Meadow "spirit" is one of cooperation. And remember: 
Guido is watching. 

1. Keep your messages on-topic -- On occasion, the Moderator may 
get the feeling that message content is inappropriate or has the 
potential to attract a barrage of inappropriate messages. In such 
instances, the Moderator will post a reminder of the rules or 
send netmail. It's not personal. If you post an off-topic 
message, let it be for comic relief and the fostering of 
friendships. 

2. Be excellent to one another and keep your sense of humor -- 
Personal attacks (thinly disguised or not) are prohibited. The 
useful exchange of information requires you to accept that people 
have opinions or experiences which contrast yours. The object of 
this conference is to learn from others, not argue with them. 

3. Be helpful -- If you can help someone with a technical 
problem, PLEASE do, but avoid blind guesses. You'd be doing a 
disservice. If you're not certain of a proper response, wait a 
few days to see if someone out there has the definitive answer. 
Then everyone learns something. 

4. Never use Meadow to reply to inappropriate messages -- If you 
feel a message is inappropriate, simply take a deep breath and 
ignore it. It'll go away. And if it doesn't, LET THE MODERATOR 
HANDLE THE PROBLEM. If you feel particularly strong about a 
specific posting, send the Moderator private netmail, or take 
your beef off-echo and flame the person directly. Leave the 
others out of it. The Moderator has probably already addressed 
the problem via netmail. 

5. Keep your quotes to a minimum -- People read Meadow regularly; 
you don't need to quote and explain the obvious. If you get a bad 
case of quotitis, the Moderator will come over to administer 
something you hated as a kid. 

6. Keep your messages public and without nuisances such as 
encryption, encoding, or rotation -- If you have a driving need 
to send a private or fancy message, there's something intriguing 
out there called netmail. Use it. 

7. Keep to a minimum BBS ads and notices on new conferences or 
toys-- Such advertisements and so on should be restricted to no 
more than ONCE per month. We hear ya, already. 

HANDLES: While not encouraged, "handles" or anonymous names are 
permitted provided they are not used with the intent to conceal 
the identity of a person posting malicious, annoying, or illegal 
messages. Please include your proper name someplace on every 
message. _ 


145 






Oput»CBCS Sytop OpToflont Manual 


NONCOMPLIANCE: If you cannot abide by and comply with the rules, 
you are requested to forego posting messages to this conference. 
Anyone who posts inappropriate messages will be warned of the 
infraction. If such postings continue, you will be asked to drop 
the conference. If you do not drop the conference voluntarily, 
the system(s) uproute will be asked to disconnect your feed. This 
method of keeping the Meadow interesting and productive is not 
preferred. It is preferable that participants simply abide by the 
rules and "spirit" of the conference, and that they serve one 
another. 

Bev Freed -- Meadow Moderator and Uppity Wench, 1:129/104 
freed©nss.fidonet.org 

- Opus-CBCS 1.14 

* Origin: NSS BBS - Ad Astra! (412)366-5208 ^HST* (1:129/104.0) 


From: Bev Freed 
To: All 

Subj: Rules follow-up 
NOTICE ON OPUS DEVELOPMENT 

Opus isn’t something you slam in and let 'er rip. It's an ongoing 
project which means it's ALWAYS under development. It's fostered 
by the entire Opus community -- Lower Code Dwellers (LCDs) as 
well as Opus sysops and grizzled veterans -- within an 
environment of participation, cooperation, and above all, 

PATIENCE. The list at the bottom of this notice changes as needed 
to address many of the complaints/requests in Meadow. 

BUG/SECURITY PROBLEMS: In the course of all human events, we 
encounter problems. And so it goes with Opus development. When 
you feel you've encountered a real nasty bug or security problem, 
send your reports via DIRECT netmail to 1:119/25 or 1:129/104. 
Otherwise, use Meadow. Someone out there has probably already 
solved your troubles. 

NEW RELEASES: Please don't ask when the next version of OPUS will 
be released. You'll always receive the standard answer: WHEN IT'S 
READY. The LCD's maintain Opus as a hobby. It isn't a full-time 
job for anyone. No one is making money from this. After the beta 
and gamma testers have had their chance to break Opus, the 
new(est) version will be released for everyone. Please be 
patient. And when it's ready, you'll hear it on Meadow first. :-) 

SEND CODE: If you have a suggestion, try to provide as complete 
an explanation/model/example/source-code as you can. Even a chunk 
of BASIC code is better than nothing at all. Send code to Doug 
Boone at 119/25. 

SEND DOCS: If you have a good explanation of how to handle 
aspects of Opus or integration of tricks and utilities, please 
share them. Send docs or a note that you have them on hold to 
Trev Roydhouse at 3:711/401 (PEP) or 3:711/501 (V32). _ 


r 
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APPENDIX A: COMMENTED NERF.BAT 


©ECHO OFF 
C: 

CD C:\OPUS 

REM make sure we are where we think we are 


XOO B,0,19200 T=8192 R=4096 F=12 
XU CAPTURE 

REM load the comms fossil and make sure it has 
REM control of the comms interrupt 

:MODEM 

SET OPUS=BBS 
SET TZ=UTC-10 

REM set up some environment variables, especially the 
REM timezone (tz) so that opus can keep track of events 

AT COMl: s2=255s7=50s50=0s52=ls53=ls54=4q0vl 
AT COMl: s0=0s9=12s51=5s58=2s66=ls68=2s90=le0x3&w 
REM initialise the trailblazer 


OPUSDATE + NERF ** Sentry Opus On-line ** » C:\opus\opus.log 
REM make a log entry 


:OPUS 

CHAT120 25 
OPUS BBS 

REM load the chat fossil and run opus using the bbs 
REM parameter file produced from the bbs.ctl file by nacl 


:TEST 

IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
IF ERRORLEVEL 
GOTO ERRORO 


255 GOTO ERROR255 
16 GOTO MASH 
12 GOTO DOS 
9 GOTO OPUS 
4 GOTO ERROR4 
3 GOTO ERROR3 
2 GOTO ERROR2 
1 GOTO OFFLINE 


REM test for various dos errorieveis so that 


REM we can take the appropriate action 


:MASH 

OMMM 

GOTO OPUS 

REM run oMMM to bundle mail and then rerun opus 
:DOS 

OPUSDATE # NERF Sysop dropped to DOS » c:\opus\opus.iog 
REM log that sysop is heading for dos 

NEWBAUD C:\OPUS\LASTUSOO.DAT 


IF ERRORLEVEL 96 GOTO REMOTE_DROP 
IF ERRORLEVEL 48 GOTO REMOTE_DROP 
IF ERRORLEVEL 24 GOTO REMOTE_DROP 
IF ERRORLEVEL 12 GOTO REMOTE_DROP 
IF ERRORLEVEL 3 GOTO REMOTE_DROP 
IF ERRORLEVEL 0 GOTO LOCAL_DROP 

REM newbaud reads the baud rate from Iastus00.dat and exits 
REM with an errorievei = baud/100 so we can check if the 
REM sysop logged on from the keyboard 

:REMOTE_DROP 
FSU 1 ON + 

CTTY COMl: 
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ECHO ## Type EXIT to return to Opus ## 

ECHO ** Carrier Monitoring in effect ** 

REM sysop must be logged on remotely so 
REM turn on modem carrier watchdog and 
REM redirect screen and keybaord to the 
REM comms port 

:LOCAL_DROP 
COMMAND 

REM we are here either because we fell through from 
REM remote_drop, or the sysop logged on from the 
REM keyboard 

:RETURN 
C: 

CD C:\OPUS 
FSU 1 OFF - 

OPUSDATE # NERF Sysop returned from DOS » c:\opus\opus.log 
CTTY CON 

REM make sure we are in the opus directory when returning 
REM from dos, turn off carrier watchdog, log sysop's return 
REM and cancel redirection of screen and keyboard 

OPUS BBS -0 
GOTO TEST 

REM restart opus with the relog option and loop back to 
REM errorlevel tests NOTE: after relog exit is set to 9 
REM so that after the sysop logs off opus will exit with 
REM errorlevel 9 and be rerun without the -o relog switch 

:ERROR0 

OPUSDATE ! NERF Errorlevel not detected in TEST » 
c:\opus\opus.log 
GOTO OPUS 

REM log error and rerun opus 
:ERR0R2 

OPUSDATE ! NERF Opus Errorlevel 2: Recycling » c:\opus\opus.log 
GOTO OPUS 

REM log error and rerun opus 
:ERR0R3 

OPUSDATE ! NERF Opus Errorlevel 3: Halting » c:\opus\opus.log 

GOTO OFFLINE 

REM log error and halt 

:ERR0R4 

OPUSDATE ! NERF Opus Errorlevel 4: Recycling » c:\opus\opus.log 
GOTO OPUS 

REM log error and rerun opus 
:ERROR255 

OPUSDATE ! NERF MSC Stack Error: Recycling » c:\opus\opus.log 
GOTO OPUS 

REM log error and rerun opus 
:OFFLINE 

OPUSDATE : NERF ** Sentry Taken Offline ** » c:\opus\opus.log 
ECHO ON 

REM log system taken offline _ 
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AIDS, 1 
Alaska, 54 
alias, 18 
all, 141 
Amdec, 143 
AmFAR, 1 

anonymouse messages, 18 
ANSI, 19, 26, 66 
ARC compression, 80 
ARCA.COM, 69, 80,102 
ARCE.COM, 69, 102 
ARCMAIL, 75 
area name, 119 
AREAINFO, 137 
AREAINFO.BBS, 40 
AREAS.CTL, 23 
Arkansas, 88 
ASCII, 36 

menu, 29 
Asia, 88 
ass, 139 
asstsysop, 132 
AT.COM, 64 
Atlanta, Georgia, 146 
Australia, 2, 4, 88, 94, 105 
echomail, 121 
echomail routing, 124 
OPUSinfo, 146 
Perth, 54 
Sydney, 54 
Australia, Sydney, 81 
AUTOEXEC.BAT, 54 
Avatar, 2,19, 26, 65 
AVATAR.SYS, 3 
Award BIOS, 143 
AxeUser, 50 


B 

Back To The Future, 81 
backbiting, 144 
backbone, 108 
BADECHO, 138 
bark, 19, 91 
barricaded areas, 46 
barricaded message area, 18 
barricades, 133 
batch file, 101 
baud 

netmail, 74 
BBS EXIT, 128 
BBS files, 66 

BBS.CTL, 22, 23, 30, 42, 76 
echomail, 126 
netmail, 74 
sections, 51 
BBS.PRM, 22, 23, 76 
BBS>PRM, 126 
Beebe, William, iii, 67 
Beeler, Jim, 143 
behaviour windows, 78 
Bernoulli Box, 16 
Berring, 54 

BinkleyTerm, 94,127,128 
example, 129 

AFTER ARCMAIL EXTRACT PACKETS, 75 Bloom County 5 

AFTER EDIT EXIT, 78 Bolton, Bill, 3 ’ 

AFTER RELOG EXIT, 49 bombing runs, 29 

AFTER TOSS EXIT, 126 Boone, Doug, 3, 4, 49, 69, 73, 81,83,118,148 


Index 


$ 

$ symbol, OKFILE, 93 


+ 

+<ALE+SECTOPM, 52 


:-([frown], 121 
:-) [grin], 121 


9 

;-) [wink], 121 



@ symbol, OKFILE, 92 


FILE, 27 
MESSAGE, 27 
OUTSIDE, 26 
OUTSIDE EXIT, 49 
PICK_SECTION, 52 
SHOW, 26 


8 

80286, 75 
80386/SX, 67 


A 

AA.COM, 102 
ABOUT file, 92, 95 
access, see security 
action requests, 93 
ADDRESS, 75 
address format, 90 
Africa, 88 
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BossNode, 104 
bossnode 

set up, 105 

bounced mail, joy of, 113 
Bpius, 7 

Bratislava, Czechoslovakia, 54 
BTW, 121 

Buerg, Vernon D., 69 
bugs 

reporting, 148 
bundles, mail, 78 
BYEBYE.BBS, 15, 30, 35 


c 

California, Chico, 81 
call, forced, 97 
Canada, Yukon, 54 
carrier monitoring, 150 
CAYENNE, 38 
CBS telivision, 103 
CD-ROM, 41,43 
Central Standard Time, 54 
chat, 67 

example, 149 
OPHONE, 38 
chat FOSSIL, 67 
CHAT##, 15, 35 
CHAT.COM, 67 
CHATTER converence, 122 
checklist 

new file area, 42 
new message area, 38 
Chico, California, 81,143 
Christensen, Ward, iv 
Cicero, 146 
Citadel BBS, 51 
clear undialables, 97 
clerk, 132 
CLO files, 80, 81 
CM, 58, 80, 82, 84, 85 
command buffer stuffing, 36 
conference, 119 
CONFHELP.BBS,28 
config menu 

new features, 8 
CONFIG.SYS, 76 
CONFILE, 38, 42 
Confucius, 31, 104 
consumerism, 91 
continuous mail, 58, 82 
control file 

equipment section 
new features, 10 
expiration control, 50 
language section 

new features, 10 
macros, 24 
matrix section 

new features, 10 
section, 53 
session section, 49 
new features, 11 
system section 

new features, 9 
Coolidge, Calvin, 22 
CRASH mail, 77, 81,85 
CRT files, 79 
CTS, 74 


CTTY, 149 
customized menus 
new features, 9 
CUT files, 79 
CWF, 47, 48 
Czechoslovakia, 54 


D 

Dallas, 89, 122 

Dataplex, 16 

Davis, Bob, 3 

DemoteUser, 50 

DESQview, 67 

DIAL PREFIX, 74 

DIAL SUFFIX, 74 

directory assistance system, 94 

disgrace, 132 

disk maintenance, 40 

DLO files, 80, 85 

DOG, 40 

DOORMAGIC, 38 
DOS, 17 

drop to, 149 
DOS command, 63 
DOS environment, 102 
download limits, 57 
DOWNLOAD LOCK, 26 
DOWNLOAD PRIV, 26 
dress code, 144 
DRT files, 79 
DTR, 16 
DUPES, 41 
DUT files, 79 


E 

Eastern Standard Time, 54 
ECHO GUARD, 138 
ECHO.MDX, 22 
echomail, 2,119 
cost, 120 
delays, 120 
getting started, 124 
history, 122 
hub, 121 
Meadow, 146 
message area, 125 
new features, 20 
point, 105 

private messages, 119 
routing, 124 
scan, 97,126 
scan event, 59 
security, 137 
tutorial, 119 
ED_UUCP, 110,117 
EDIT DISABLE USERLIST, 134 
EGA, 143 

Emerson, Ralph Waldo, 1 
ENGLISH.MNU, 22, 28 
ERRORLEVEL, 78, 101,127 
batch file examples, 149 
Europe, 2, 88,120 
events 
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behaviour windows, 78 

controlling costs, 58 

external, 56, 129 

housecleaning, 59 

mailer, 57, 128 

management, 69 

matrix behaviour window, 57 

OEVENT, 38 

overview, 55 

scan, 59 

setup, 61 

types, 55 

user, 56 

yell, 59 

eventsjoverlapping windows, 60 
everyone, 141 

expiration control system, 50 
EXPIRE DAYS, 51 
EXPIRE MINUTES, 51 
EXPIRE PRIV, 50 
external event, 56 
external events, 129 
external programs, 38 
extra, 132 


F 

RELOCATE, 52, 131 
F_NEW, 52, 131 
FI.BAT, 64 
favored, 132 
FIdo, 4, 5, 147 
FidoNet, 5, 57 
getting in, 87 

International Coordinator, 69 
poll, 97 

standard compression, 80 
fidonet.org, 118 
FIDOUSER.LST, 110 
file menu 

new features, 9 
file request 

security, 138 
file requests, 58, 84 
magic names, 92 
file transfer, 18 
files 

area maintenance, 45 
area numbers, 42 
area system file, 23 
barricaded areas, 46 
CD-ROM, 41 
creating areas, 42 
download limits, 57 
inbound path, 75 
OFARE, 38 
OPUS-FAM, 38 
overview, 41 
PTIC, 38 

sample area definition, 44 
files database 

new features, 12 
FILES file, 95 
FILES.BAK, 45 
FILES.BBS, 38, 41,42,45 
FILESBBS.ADX, 41 
FILESBBS.DAT, 41 
FILESBBS.NDX, 41 
Finster, David, 2 


Fischer, Joseph, 31 
FLO files, 80 
flow file name, 80 
folklore, 142 
forced event, 55 
FORMAT C:, 134 
Forsberg, Chuck, 4 
FOSSIL, 3,16,17, 76,128 
FR# files, 80 
FREE, 42 

Freed, Bef, 118,147 
Freed, Bev, 3,107, 148 
Freed, Beverley, 4 
front-end, 57 
FrontDoor, 65, 128, 129 
FSC0050, 10 
FSU, 150 
FTB, 37 

full-tilt boogie, 37 
function keys, 66 
FWIW, 121 


G 

GATED, 118 
gateway 

UUCP, 107, 114 
GBS file, 26 
GBS files, 66 
Georgia, 146 
goop, 71 

Gracian, Baltasar, 142 
gravity, laws of, 145 
Greenwich Mean Time, 54 
grizzled, see veteran 
Guido, 64, 87, 93, 95, 122,142 
GUUCP, 107,109 


H 

hardware, required, 16 
Hartman, Bob, 2, 69 
Hatch, Dave, 4 
Hayes, 16 
hidden, 132 
history menu 

new features, 8 
HiTech menu, 43 
HLO files, 80 
hold area, outbound, 75 
host system, 121 
housecleaning, 59, 98 
housecleaning event, 55 
HRT files, 79 
HST, 143 

clear buffer, 74 
HST/DS, 9 
hub, 124 

echomail, 105 
Huebner, Rick, 2,100 
HUT files, 79 


I 

IMHO, 121 
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IMNSHO, 121 
inbound files path, 75 
inbound message path, 75 
inbound-only message area, 18 
informal event, 55 
INMAIL##.$$$, 10 
intransit mail, 138 


j 

Japan, Tokyo, 143 
Jennings, Tom, iv, 5 


K 

Kashuba, Tom, 3, 4 
KCD, 121 
Kelleher, Mike, 3 
Kelly, Paul, 3, 4, 73 
Kermit, 19 
keyboard, 62, 66 
keys, 132 
KISS, 20 
Klahn, Bob, 144 
kludge line, 108 


L 

L8R, 121 
LANGDIR, 23 
lastread pointers, 7 
LASTUS##.DAT, 15 
law, natural, 145 
law, unnatural, 145 
lawful and friendly, 2 
Lawson, Chuck, 122,123 
LCD, 96, 148 
Levian, Roger, 6 
LFILE.DAT, 40 
Lilly, Robert, 4 
limited, 132 
local-only, 58 
locks, 132 

login from keyboard, 65 
LOGON SECTION, 53 
LOGON XDAYS, 50 
LOGON XMINS, 50 
LORE 

file request, 96 
UUCP, 109 
UUCPIlst, 113 
LORE menu 

new features, 9 
Los Angeles, 1 
Louisianna, 88 
Lund, Sweden 

OPUSinfo, 146 


M 

macros 

control file, 24 

magic file name requests, 92 


mail, 58 

mail bundles, 78 
mail only, 58 
mailer 

events, 128 
external, 127 
mailer event, 55, 57 
mailer, external 

new features, 11 
MAILER.BAT. 11 
MAKESECTION, 53 
manners, 91 
Marshall, Jon, 3 
mass, critical, 123 
Masterson, Michael, 3 
matrix 

a dissenting view, 71 
action requests, 93 
address, 75 
address format, 90 
address, getting a, 87 
automatic processing, 75 
batch file, 101 
behaviour window, 83 
compressed bundles, 69 
controlling costs, 58 
controlling outbound calls, 82 
CRASH mall, 85 
default behaviour, 77 
event flags, 58 
file requests, 91 
finding a network, 90 
flow file name, 80 
flow of a message, 81 
forced call, 97 
getting In, 87 
how to behave, 91 
intransit, 138, 144 
mall only system, 84 
menu, 97 
message area, 75 
network coordinator, 90 
nodelist, 69 
overview, 67 
required files, 68 
script, 98 
security, 137 
structure, 88 

unsuccessful connection, 98 
update request, 96 
matrix behaviour window, 57 
matrix event, 55 
Meadow, 2, 4 
rules, 147 

Meadow coordinator, 146 
menu 

area-by-area, 27 
ASCII, 28 
editor, 117 

external programs, 26 
files, 23 

global commands, 27 
handling, 118 
matrix, 97 
multi-lingual, 28 
OEC, 29 
OEC file, 26 
section, 52 
system overview, 25 
MENU.CTL, 23 
MENU_COMMAND, 25 
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menus 

new features, 7 
merit badges, 145 
message menu 

new features, 8 
MESSAGE_EDIT, 29 
messages 

area attributes, 18 
area mantenance, 40 
area system files, 23 
barricaded areas, 46 
bombing run, 29 
CRASH mail, 77 
echomail area, 125 
for next caller, 35 
inbound path, 75 
invisible areas, 39 
matrix, 75 
new areas, 38 
new features, 13 
0_RENUM, 38 
off-line reader, 89 
private echomail, 119 
sample area definition, 39 
scope, 17 
Michal, Robert, 4 
Microsoft, 55,101 
Miller, John, 3 
Milliv\/ays BBS, 146 
mind, fusion of, 123 
MO# files, 80 
modem, rogue names, 140 
Mountain Standard Time, 54 
mouse, 10 
MS-DOS, 17 
MSG^FORWARD, 29 
MSG_NAREA, 51,52, 131 
MSG_RULES, 40 
MSG_SCAN, 52, 131 
MultITech, 16 
MYOB, 121 


N 

NACL, 23, 28, 38, 42, 43, 76, 102, 126 
macros, 25 
new features, 7 
NAKED, 96 
name filter, 139 
NAME.FDX, 22 
NAME.MDX, 22 
NAMEFILTER, 139 
names, shy caller, 141 
Neghila, Harv, 122 
Nepal, 71 
NERF FREE, 142 
NERF.BAT, 26, 37, 49, 77 
commented example, 149 
echomail, 126 
history, 142 
net host, 87,124 
NETJNFO, 98 
Netcomm, 16 
NETINFO, 75 
netmail chat, 122 
netowrk host, 90 
network, 89 
network host, 105 
NEW PRIV, 41 


New Zealand, 88 
NEWBAUD, 149 
niel keys, 66 
Niel-Key 

new features, 15 
Nilsson, Ulf, iii 
node, 89 
nodelist, 68 

UUCP, 112 
version six, 75 
nodelist, version seven, 9 
NODELIST.DAT, 58 
NODELIST.TXT, 119 
normal, 132 
North America, 88,120 
echomail routing, 124 
North Sydney, Australia, 90 
NS BBS, 146 
NSS BBS, 148 
NUMBER.FDX, 22 
NUMBER.MDX, 22 
Nunzio, 95 


o 

0_RENUM, 38 
OEC, 66 

command stuffing, 36 
file stacking, 35 
menu, 26 

new features, 14,19 
peak time access, 37 
questionnaires, 33 
security, 137 
simulated menu, 29 
special, 47 
OEC files, 30 

OEVENT, 26, 38, 61,69, 76 

OFARE, 38, 42, 43, 45 

OKFILE, 91 

OKIT, 143 

Oklahoma, 88 

OMAIL, 94, 95 

OMAN, 3 

oMMM, 3, 68, 69, 76, 78, 81 
batch file example, 149 
batch file usage, 101 
echomail, 126 
technical support, 146 
oMMM.CFG, 76 
ONECM, 81 
ONEDIRECT, 85 
ONEHOLD, 79 
OOMP, 2 

OPARSE, 69, 73, 75 
OpEd, 65 

file request, 96 
UUCP, 109 
UUCPIist, 113 
OpEd menu 

new features, 9 
opera, 5 

OPHONE, 38, 67 
OPMED, 10 
oPOLO, 144 
Optimize, 40 
Opus 

paper mail, 146 
Opus-CBCS 
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batch file, 149 

By-Laws & Covert Action Committee, 1 
Bylaws and Covert Action Committee, 142 
Enforcement Squad, 144 
fees, 1 
guarantee, 2 
how you can help, 148 
new features, 6 
pholosophy, 20 
reporting problems, 148 
setting up, 22 
OPUS-FAM, 3, 38, 45 
OPUS.EXE 

command-line, 128 
OPUSarchive, 146 
OPUSCOMM.COM, 76 
OPUSinfo, 2, 146 
OPUSinfo Snail, 146 
origin line, 119 
ORT files, 79 
OTIC, 38 
OTOH, 121 
OUFM, 38, 47. 48, 51 
OUT files, 126 

Out of the Skillet Into the WOC, 145 
outbound hold area, 75 
OUTBOUND.### directories, 10 
outside security, 134 
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PABX, 74 

Pacific Standard Time, 54 
PARSELST, 69, 73, 98 
PARSELST.CFG, 73 
party, pizza, 122 
password 

barricaded areas, 46 
matrix, 137 
passwords, 133 
PATH BADECHO, 138 
PATH environment variable, 102 
PATH INBOUND FILES, 75 
PATH INBOUND MESSAGES, 75 
PATH MISC, 64, 66 
PATH NETINFO, 75 
PATH OUTBOUND HOLD AREA, 75 
PC Pursuit, 100 
peak time caller access, 37 
penguin, 5 
PEP. 148 

Perth, Western Australia, 54 
phone 

call cost, 84 
call frequency, 58, 84 
controlling calls, 82 
directory, 68 
forced call, 97 
local calls only, 87 
long distance, 57 
long distance calls, 86 
PKT files, 97 
Plato, 107 
point, 89,104 

becomming a, 105 
setup, 106 
pointnet, 104 
points 
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POLITICS conference, 122 
poll, 97 

potty-mouth, 139 
print, fine, ii 
privil, 132 
privilege level 

changing for an area, 133 
privilege levels, 132 
menu, 25 
PRM file, 56 
programs, externsi, 38 
PSTN, 17 

PUBLIC MESSAGES ONLY, 125 
public-only message areas, 18 


Q 

QBBS, 147 
questionnaire, 19 
active, 33 
passive, 32 

quote of the moment, 30 
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read-only messages, 18 
REBOOT. 134 

REFUSE FILE REQUESTS, 91 
REFUSE HUMAN CALLERS, 82 
REFUSE INBOUND TRAFFIC, 127 
Region, 88 

region coordinator, 124 
RELOG, 49 

batch file example, 150 
relogging, 49 
remarks, snide, 144 
REQ file, 19 
REQ files, 94 
ROFL, 121 
ROUTE.CTL, 81 
routine 
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RULES.BBS, 8, 40, 42 
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SA# files, 80 
Sabol, Jon, 3, 29, 119 
San Francisco, 122 
scan, 97,126 
scan all event, 59 
scan event, 55 
SCANMAIL, 122 
SCHED.BBS, 54 
script, matrix, 98 
SD,40 
SEAdog, 29 
SEAlink, 5,19 
SECTION, 53 
section menu 
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new features, 7 
sections, 51,131 
menu, 52 
sysop-defined, 51 
user-defined, 52 
SECURE, 49 
security, 131 

area access, 136 
barricades, 46,133 
echomail, 137 
file request, 138 
guidelines, 134 
locks and keys, 132 
long distance calls, 138 
matrix, 137 
menus, 135 
OEC, 137 
outside, 134 
passwords, 133 
privilege levels, 132 
sections, 131 
session passwords, 137 
user list, 133 
SEEN-BY, 106 
SEND CM, 82 
send code, 145,148 
SEND LOCAL, 75, 82 
SEND NOTHING, 82 
Sentry BBS, 105 
Sentry System, 146 
Sentiys Shadow, 146 
session-level password, 137 
Sevareid, Eric, 103 
shit, 139 

SIGs, 7, 22, 51, 131 
Smollet, Tobias, 127 
software, required, 17 
South America, 88,120 
SPANNs, 47 

speca, see OPUSarchive 
SPOEC, 47, 48 
Springfield, NSW, 90 
Stair, Graham, 4 
Stanislav, George, 3, 4, 67 
SU# files, 80 
Sundblom, Thomas, 3 
sunglasses, mirror, 143 
Sweden 

OPUSinfo, 146 

Sydney, Australia, 54, 81,94,120 
OPUSinfo, 146 
SYFILE.DAT. 22 
SYSMSG.DAT, 22 
sysop, 132 

keyboard, 62 
on-line from keyboard, 65 
SYSOP conference, 122 
SYSOP.NDX, 110 

System Enhancements Associates, 5 
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Tainan, Taiwan, 146 
Taiwan, 2 

OPUSinfo, 146 
TBBS,51,131,147 
TECH conference, 122 
TeleBit, 16 


Trallblazer, 143 
Telink, 19 
Texas, 88, 89 
TH#files, 80 
ticked files, 38 
time multiplier, 57 
time travellers, 60 
time zone, 54 
TinyTerm, 65 
TNSTAAFL, 121 
Tokyo, Japan, 143 
torpedoes, photon, 66 
TOSSMAIL, 122 
trashcan, 139 
TTFN, 121 
TTY, 19, 26 
TU# files, 80 
Twain, Mark, 131 
twit, 132,137 

TZ environment variable, 54, 60,102 
example, 149 
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U.S. Robotics, 143 

UDS, 52 

UFGATE, 110 

UNCM, 81,85 

UNCON, 38, 42, 45 

undialables, clear, 97 

Universal Coordinated Time, 54 

Unix, 107 

unnatural laws 

enforcement of, 145 
unpack matrix, 97 
UseNet newsgroups, 108 
user 

event, 55, 57 
example, 61 
expiration control, 50 
list, 8, 133 
maintenance, 47, 51 
OUFM, 38 
time limits, 57 
user events, 56 
USES BADNAME, 139 
USES BARRICADE, 46 
USES FILEREQ OKFILE, 91 
USES MAKE, 53 
USES NAMEFILTER, 139 
USES SCHEDULE, 54 
USES SECTMENU, 53 
USES UUCPIist, 109 
USES VERSION 6, 75 
USES WELCOME, 47 
USES XDGONE,51 
USES XDWARN, 51 
USES XTGONE, 51 
USES XTWARN, 51 
UUCP, 107 

address string, 108 
new features, 11 
procedures, 114 
proper address, 113 
UUCPIist, 109, 112, 117 
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V 

Valentyn, John, iii, 4 

Vauvenargues, 119 

veteran, grizzled, 30, 41,54, 96, 143, 148 
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